Справочник API

Справочник Atasu Maps API собирается автоматически из спецификации openapi.yaml. Описания операций — на английском.

Спецификация 1.0.0-draft.1: доступно операций — 26, запланировано — 15.

Map sessions & styles

Map session, tile token and style JSON. Tile token format is in the `TileToken` security scheme.

POST/v1/map-sessionsStart a map session and get a tile tokenДоступно
POST/v1/map-sessions/{session_id}/tokensRefresh the tile token of a live sessionДоступно
GET/v1/styles/{style_id}.jsonMapLibre style JSONДоступно

Vector tiles on tiles.atasumaps.com. Served by Martin / traffic-edge, not by apps/api.

GET/v1/basemap/{z}/{x}/{y}.mvtBasemap vector tile (OSM + Overture, ODbL)Доступно
GET/v1/canopy/{z}/{x}/{y}.mvtTree canopy height classes (Meta & WRI, CC BY 4.0), Almaty and AstanaДоступно
GET/v1/overlay/{z}/{x}/{y}.mvtApproved crowdsourced places and entrancesДоступно
GET/v1/reports/{z}/{x}/{y}.mvtLive road events (z ≥ 10)Доступно
GET/v1/fonts/{fontstack}/{range}.pbfGlyph range of a font stack (the style's `glyphs` URL)Доступно
GET/v1/sprites/{sprite_file}Sprite sheet image or index (the style's `sprite` URL)Доступно
GET/v1/native-styles/{style_file}Static style for MapLibre Native (one theme, Kazakh labels)Доступно
GET/v1/native-styles/patches/{patch_file}Theme or language patch for a native styleДоступно
GET/v1/traffic/tiles.jsonTileJSON for the traffic flow source (zoom range, coverage, TomTom attribution)Доступно
GET/v1/traffic/{z}/{x}/{y}.pbfTraffic flow tile (TomTom through the budgeted proxy)Доступно

Autocomplete, address search, reverse geocoding with entrances.

GET/v1/geocode/autocompleteType-ahead suggestions (kk / ru / en, mixed Cyrillic and Latin)Доступно
GET/v1/geocode/searchFull-text and structured address / place searchДоступно
GET/v1/geocode/reverseCoordinates → address and nearest entranceДоступно

Place details with entrances.

Route, ETA, matrix, map matching, pickup points.

POST/v1/routeDriving / walking route with alternatives and turn-by-turn stepsДоступно
POST/v1/etaFixed-route live travel time (for quotes)Запланировано
POST/v1/matrixSources × targets travel-time matrix (dispatch)Запланировано
POST/v1/snapMap-match a GPS trace to roadsЗапланировано
POST/v1/pickup-pointsRecommended pickup points — stairwell entrances, compound gates, legal stopsЗапланировано

Live road events and "still there / gone" votes.

POST/v1/reportsReport a road eventДоступно
POST/v1/reports/{report_id}/votesVote "still there" / "gone" on an eventДоступно

Crowdsourced places, entrances and fixed cameras. Never pre-filled from OSM.

POST/v1/places/submissionsSubmit a new place, a place edit, an entrance or a fixed cameraДоступно

The signed-in user — profile, devices, my submissions, appeals, deletion, rewards.

GET/v1/meCurrent userДоступно
PATCH/v1/meUpdate display name or localeЗапланировано
POST/v1/me/devicesRegister this deviceЗапланировано
GET/v1/me/submissionsMy submissions and reports with their statusДоступно
GET/v1/me/submissions/{report_id}One of my submissions, with status historyДоступно
POST/v1/me/submissions/{report_id}/withdrawWithdraw a pending submissionЗапланировано
POST/v1/me/submissions/{report_id}/appealAppeal a rejected submission (once)Доступно
POST/v1/me/submissions/{report_id}/mediaAttach a photo to my submissionЗапланировано
GET/v1/me/deletion-requestStatus of my deletion requestЗапланировано
POST/v1/me/deletion-requestRequest deletion of my dataЗапланировано
GET/v1/me/rewardsMy jarmaq grant history (Beta; off until its tests pass)Запланировано

Partner fleet positions and passenger trip sharing.

POST/v1/fleet/positionsPublish vehicle positions (HTTP alternative to the stream `pub` op)Запланировано
POST/v1/tripsStart sharing a trip (vehicle ↔ passenger)Запланировано
POST/v1/trips/{trip_id}/ticketsIssue a short-lived passenger ticket for a tripЗапланировано
POST/v1/trips/{trip_id}/endEnd a trip; tickets stop working and subscribers get a tombstoneЗапланировано

WebSocket endpoint; protocol in packages/openapi/WEBSOCKET.md.