Туршуур
- Хайлт · Хаалга олох · Зам: нэг дуудлага, хүсэлт, JSON, газрын зураг.
Түлхүүрээ оруулах эсвэл үнэгүй түлхүүр аваад хайлт, цэгээр хайлт, барилгын код, tile-г хөтөч дээрээс туршина. Хүсэлт бүрийг JS SDK (@dock/js) хийдэг. Илгээсэн хүсэлт, ирсэн хариуг доор харуулна. Мөн адил дуудлагыг SDK болон curl-ээр яаж бичихийг харуулна. Хариу бүр API-ийн бодит хариу. Албан ёсны хаягтай таараагүй бүх зүйл unofficial: true гэж ирнэ. Хайлт, Цэгээр табад зөвхөн тодорхой төрлийг (types) чагтлана: гудамж сонгогч бол street. Хайлтын Ойролцоо (proximity) талбарт уртраг,өргөрөг эсвэл Tile табын зургийн төвийг оруулна: нэр адил сайн таарвал ойрынх нь эхэнд. Цэг дээр таб (tilequery) цэг дээр эсвэл ойролцоох барилга, хаалгыг өгнө. Tile табын зураг энд гарч, дарсан цэгийг асууна. Хүрэх бүс таб (isochrone) эхлэлээс 1-4 хугацаанд (минут) хүрэх бүсийг SDK-ийн isochroneLayers-ээр зурагт зурна. Зурагт дарвал тэр цэгээс асууна. Хүснэгт таб (matrix) 1-10 эхлэл бүрээс 1-10 төгсгөл бүр хүртэлх хугацаа (минут), зайг (км) нэг дуудлагаар хүснэгтээр харуулна. Дараалал таб (optimized-trips) 2-12 зогсоолыг замд хамгийн бага хугацаа зарцуулах дарааллаар өгч, замыг SDK-ийн optimizedTripLayers-ээр зурагт зурна. Зурагт дарвал зогсоол нэмнэ. Замд буулгах таб (matching) 2-100 цэгтэй GPS мөрийг замын сүлжээнд буулгаж, явсан замыг SDK-ийн matchingLayers-ээр зурагт зурна, цэг бүр аль хэсэгт, хэдэн метрт буусныг жагсаана. Зурагт дарвал цэг нэмнэ.
Газар табаар хайлтын өгсөн id-аар нэг газрыг дахин авна. Өөрчлөлт, Баталгаа табад түншийн түлхүүр хэрэгтэй: Өөрчлөлт нь тодорхой цагаас хойш өөрчлөгдсөн газруудыг хуудсаар өгнө, Баталгаа нь газар дээрх жолоочийн баталгааг хадгална. Баталгаа жинхэнэ мэдээлэл тул газар дээр байгаагаа чагтлахад л илгээнэ.
Нэр табаар бизнесийн хаалгандаа бүртгүүлсэн нэрээр ("Сансар бэйкери") хаалгыг нь авна. Танай байгууллагад door_names нээгдсэн байх ёстой, эс бол 403 feature_off. Утасны дугаар, и-мэйлтэй нэрийг SDK илгээхгүй.
Манай нэрс таб танай байгууллагын эзэмшдэг нэрсийг жагсааж, эхний нэрийг дараагийн табуудад оруулна. Тэмдэглэл, Зураг табууд нэрийн эзэмшигчид: танай нэрийн хаалганд бичсэн тэмдэглэл, хүний зөвшөөрсөн хаалганы зургийг уншина. names:write эрхтэй түлхүүр, hotel.notes боломж хэрэгтэй. Зургийг энд харуулахгүй, хэмжээ, sha256-г л харуулна. Энэ хуудас тэмдэглэл бичихгүй, зураг илгээхгүй: тэдгээр нь хүний хяналтын дараалалд ордог.
Түлхүүр зөвхөн энэ хуудасны санах ойд байна. Хадгалагдахгүй, хаягт орохгүй. Хүсэлт бүр таны хязгаараас тоологдоно.
Ойролцоо (proximity): хүн байгаа газар эсвэл зургийн төв. Нэр адил сайн таарвал ойрынх нь эхэнд. Хоосон бол илгээхгүй. Зургийн төв товч Tile табын зургийг нээсний дараа ажиллана.
Чагтлаагүй бол бүх төрөл, types илгээхгүй. Төрлөөр limit-ээс өмнө шүүнэ: гудамж сонгогч бол 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