Түншид: хаягийн загвар

Түнш dock-оос дөрвөн зүйл авна: код, албан ёсны мөр, түвшин, хаалганд дуусдаг зам. Энэ хуудас нь бодит гурван кодоор тэдгээрийг харуулна. Үнэ, санал энд байхгүй.

Код

Бүртгэлтэй барилга, хашаа бүр 5 тэмдэгтийн кодтой. Код нь хаалгыг заана. Олгосон кодыг дахин олгохгүй. Нэг хаалганд хоёр хэлбэр байна:

• Ярианы хэлбэр: Сансар А 8. GET /v1/geocode үүнийг олно.
• Бичих хэлбэр: 7QSVX. GET /v1/door/7QSVX үүнийг уншина.

Албан ёсны мөр

Код бүрийн ард төрийн албан ёсны хаяг байна. Мөр нь Кирилл үсгээр, дүүрэг, хороо, гудамж, байр буюу хашаа, бүртгэлд байвал шуудангийн кодтой гарна. Төрийн бүртгэлтэй таарсан нь official_status: "matched" (бүртгэлтэй). Хэсэгчлэн таарсан нь partial (хэсэгчилсэн). Таараагүй нь none (албан бус). matched биш бол хариу "unofficial": true гэж хэлнэ. Тэр үед "албан бус" гэж харуулна.

Код	Төрөл	Албан ёсны мөр (official_line)
7QSVX	барилга	Баянзүрх дүүрэг, 3-р хороо, Сансар, 8-р байр · 13381-0034
BS5SS	барилга	Сүхбаатар дүүрэг, 6-р хороо, Сүхбаатарын талбай, 1-р байр · 14201-0047
ZR2Q8	хашаа	Чингэлтэй дүүрэг, 10-р хороо, Чингэлтэй гудамж-7, 196-р хашаа

ZR2Q8 мөрөнд шуудангийн код байхгүй: бүртгэл өгөөгүй тул бид нэмж бичээгүй. Гурван мөр GET /v1/door/{code}-ийн бодит хариунаас авсан (/api-examples.json, 2026-10-20).

Түвшин

Геокод, ойролцоох газрын мөр болон хаалга бүр итгэлийн түвшинтэй (confidence, 0-ээс 4) байж болно. null гэвэл мэдэгдэхгүй. Бид түвшинг зохиохгүй.

Түвшин	Утга
0	автоматаар байрлуулсан
1	зурагтай тулгаж шалгасан
2	газар дээр нэг удаа баталсан
3	бие даан гурван удаа баталсан
4	хэмжилтээр баталсан

Явах хаалганд дуусна

GET /v1/route?from=...&to=7QSVX нь кодыг барилгын гудамжны талд, хашааны хувьд хаалганд хөрвүүлнэ. Зам нь хаалгад, хаалга газрын зурагт байхгүй бол гудамж руу харсан хананд дуусна. Барилгын голд хэзээ ч дуусахгүй. Төгсгөлийн алхам 15 м-ээс урт бол сүүлийн заавар "Машинаа тавиад 17 м алхана уу." гэж хэлнэ. Ирэхэд "Хаалга зүүн талд байна" гэж гарна. Алхам бүр Монгол ба англи текстэй, гэрлэн дохиог signal талбар заана. Замын сүлжээ дууссанаас хойш үлдсэн алхах хэсгийг зам гэж зурахгүй, to.gap_m метрээр өгнө.

Дуудах

Код унших, замд код өгөхөд door:read эрх хэрэгтэй.

curl -H "Authorization: Bearer $DOCK_KEY" \
  "https://geo.dock.mn/v1/door/7QSVX"

Бүрэн хариу, талбар бүрийн тайлбар: API лавлах. Хаягийн эх, огноо хариу бүрт official_source, official_date талбарт байна.