Playground
- Search · Door lookup · Directions: one call, the request, the JSON, the map.
Paste a key, or get a free one with the button, and try search, reverse, building codes and tiles in the browser. The JS SDK (@dock/js) makes every call. The request sent and the response received are shown below, with the same call written with the SDK and with curl. Every response is the API's real answer. Anything not matched to an official address comes back with unofficial: true. On Search and Reverse, tick kinds (types) to get only those: a street picker ticks street. On Search, Near (proximity) takes lon,lat or the Tiles map centre: among names that match equally well, nearer places come first. Tilequery gives the buildings and doors at or near a point. The Tiles map shows there too, and a click asks about that point. Isochrone draws the area reached from a start within 1 to 4 times (minutes) on the map, with the SDK's isochroneLayers. A click on the map asks from that point. Matrix shows, in one call, the minutes and km from each of 1 to 10 starts to each of 1 to 10 ends, as a table. Trips puts 2 to 12 stops in the order with the least time on the road and draws the trip on the map, with the SDK's optimizedTripLayers. A click on the map adds a stop. Matching puts a GPS trace of 2 to 100 points on the road network, draws the roads it went along on the map with the SDK's matchingLayers, and lists where each point landed and how far off. A click on the map adds a point.
Place fetches one place again by the id a search gave. Changes and Confirm need a partner key: Changes pages through what changed since a time, Confirm records a driver on site. A confirmation is real field data, so the page sends one only when you tick that you are on site.
Door name finds a door by the name a business registered for it ("Сансар бэйкери"). It needs door_names open to your organization, else 403 feature_off. The SDK never sends a name holding a phone number or an e-mail.
My names lists the names your organization holds and puts the first one still held into the next tabs. Notes and Photo are for the name's holder: they read your notes for the door and the gate photo a person accepted. They need a key with names:write and the hotel.notes feature. The photo is not shown here, only its size and sha256. This page writes no note and sends no photo: both go to a person's review queue.
The key stays in this page only. Not stored, not put in the URL. Each call counts against your caps.
Near (proximity): where the person is, or the map centre. Among names that match equally well, nearer places come first. Empty: not sent. Map centre works once the Tiles tab has shown the map.
None ticked: every kind, and types is not sent. Kinds are chosen before the limit: a street picker ticks street.
JS SDK
import { Client } from '@dock/js';
const dock = new Client({ key: DOCK_KEY });
const { results } = await dock.geocode("Сансар", { limit: 5 });curl
curl -G -H "Authorization: Bearer $DOCK_KEY" "https://geo.dock.mn/v1/geocode" \
--data-urlencode 'q=Сансар' -d limit=5