# info.description
Централизованный геосервис и каталог пространственных данных Казахстана

# paths./api/v1/regions.get.summary
Все регионы как GeoJSON FeatureCollection

# paths./api/v1/regions.get.description
Returns all 20 Kazakhstan administrative regions as a GeoJSON FeatureCollection.

By default includes MultiPolygon boundaries (with_geometry=true).
Set with_geometry=false for lightweight metadata-only responses.

# paths./api/v1/regions.get.parameters[].schema.description
Включить полигоны границ (для хороплетов и карт)

# paths./api/v1/regions.get.parameters[].description
Включить полигоны границ (для хороплетов и карт)

# paths./api/v1/regions/{code}.get.summary
Один регион + метаданные

# paths./api/v1/regions/{code}.get.description
Returns a single region by ISO code (e.g. KZ-AST) as GeoJSON Feature.

# paths./api/v1/regions/{code}/cities.get.summary
Города в регионе

# paths./api/v1/regions/{code}/cities.get.description
Returns all cities belonging to the specified region.

# paths./api/v1/cities.get.summary
Все города (фильтр по ?region=)

# paths./api/v1/cities.get.description
Returns all cities, optionally filtered by region code or city type.

# paths./api/v1/cities.get.parameters[].schema.description
Фильтр по коду региона (e.g. KZ-AST)

# paths./api/v1/cities.get.parameters[].description
Фильтр по коду региона (e.g. KZ-AST)

# paths./api/v1/geocode.get.summary
Прямое геокодирование (текст → координаты)

# paths./api/v1/geocode.get.description
Forward geocoding using pg_trgm fuzzy search.
Searches regions, cities, and districts by Russian, Kazakh, and English names.
Returns best match with coordinates, region_code, and confidence score.

# paths./api/v1/geocode.get.parameters[].schema.description
Название места (напр.: Алматы, Нур-Султан)

# paths./api/v1/geocode.get.parameters[].description
Название места (напр.: Алматы, Нур-Султан)

# paths./api/v1/reverse.get.summary
Обратное геокодирование (координаты → регион)

# paths./api/v1/reverse.get.description
Reverse geocoding: given lat/lon, returns containing region and nearest city.
Uses PostGIS ST_Within when geometry is available, otherwise falls back to
nearest centroid using Haversine formula.

# paths./api/v1/locate-texts.post.summary
Пакетное распознавание локаций из текстов

# paths./api/v1/locate-texts.post.description
Batch endpoint: given a list of texts, extracts location mentions and maps them
to Kazakhstan region codes. Useful for Echo Sounder NER and Crisis Monitor.

Strategy: extract candidate phrases (capitalized words + 2-grams of capitalized
words) then geocode only the candidates. Much faster than brute-force N-gram.
For best results, pre-extract entities via QazCompute NER and send entity texts.

# paths./api/v1/choropleth.get.summary
GeoJSON с метрикой для хороплета

# paths./api/v1/choropleth.get.description
Returns GeoJSON FeatureCollection with region properties suitable for choropleth
map coloring. For built-in metrics, values are fetched from DB.
For custom project metrics, use POST /choropleth.

# paths./api/v1/choropleth.post.summary
Слияние данных метрик с GeoJSON

# paths./api/v1/choropleth.post.description
Accepts a dict of region_code → metric_value, merges with regional GeoJSON,
and returns a FeatureCollection ready for Leaflet choropleth rendering.
Useful for qaz.report ТИ/ВТИ, PSSR regional typology, etc.

# paths./api/v1/tiles/{z}/{x}/{y}.mvt.get.summary
Совместимое перенаправление на тайлы регионов

# paths./api/v1/tiles/{z}/{x}/{y}.mvt.get.description
Keep the pre-Martin URL working while consumers move to TileJSON.

# paths./api/v1/stats/regions.get.summary
Демографическая и экономическая статистика по регионам

# paths./api/v1/stats/regions.get.description
Returns regional demographic and economic statistics.
Optionally filter by region code and/or year.

Available fields: population, gdp_mln_tenge, avg_salary_tenge, unemployment_pct,
birth_rate_per_1000, death_rate_per_1000, urban_share_pct, area_km2.

# paths./api/v1/stats/regions.get.parameters[].schema.description
Фильтр по коду региона (e.g. KZ-AST)

# paths./api/v1/stats/regions.get.parameters[].description
Фильтр по коду региона (e.g. KZ-AST)

# paths./api/v1/stats/regions/{code}.get.summary
Статистика по одному региону (все годы)

# paths./api/v1/stats/regions/{code}.get.description
Returns all available yearly statistics for a single region.

# paths./api/v1/infrastructure.get.summary
Инфраструктура (дороги, ЖД, трубопроводы)

# paths./api/v1/infrastructure.get.description
Returns infrastructure objects (roads, railways, pipelines, waterways).
Geometries are LineString (SRID 4326). Returned as GeoJSON FeatureCollection.

Note: geometry is omitted by default for performance. Use ?with_geometry=true
to include LineString coordinates (can be large for highway/railway types).

# paths./api/v1/infrastructure.get.parameters[].schema.description
Фильтр по коду региона (e.g. KZ-KAR)

# paths./api/v1/infrastructure.get.parameters[].description
Фильтр по коду региона (e.g. KZ-KAR)

# paths./api/v1/infrastructure.get.parameters[].schema.description
Максимум объектов в ответе

# paths./api/v1/infrastructure.get.parameters[].description
Максимум объектов в ответе

# paths./api/v1/infrastructure.get.parameters[].schema.description
Смещение для пагинации

# paths./api/v1/infrastructure.get.parameters[].description
Смещение для пагинации

# paths./api/v1/water-bodies.get.summary
Водоёмы (озёра, водохранилища, моря)

# paths./api/v1/water-bodies.get.description
Returns water bodies (lakes, reservoirs, seas) with optional filters.
Geometries are MultiPolygon (SRID 4326), omitted by default for performance.

# paths./api/v1/water-bodies.get.parameters[].schema.description
Фильтр по коду региона (e.g. KZ-KAR)

# paths./api/v1/water-bodies.get.parameters[].description
Фильтр по коду региона (e.g. KZ-KAR)

# paths./api/v1/water-bodies.get.parameters[].schema.description
Максимум объектов в ответе

# paths./api/v1/water-bodies.get.parameters[].description
Максимум объектов в ответе

# paths./api/v1/water-bodies.get.parameters[].schema.description
Смещение для пагинации

# paths./api/v1/water-bodies.get.parameters[].description
Смещение для пагинации

# paths./api/v1/mapregion/analytics/dead-loop.get.summary
Снятая сценарная аналитика

# paths./api/v1/mapregion/analytics/dead-loop.get.description
Keep the historical route readable without returning invented scores.

# paths./api/v1/mapregion/analytics/saturation.get.summary
Снятая сценарная аналитика

# paths./api/v1/mapregion/analytics/saturation.get.description
Keep the historical route readable without returning invented curves.

# paths./api/v1/mapregion/demographics/age-sex.get.summary
Половозрастная структура

# paths./api/v1/mapregion/demographics/age-sex/{region_name}.get.summary
Половозрастная структура региона

# paths./api/v1/mapregion/demographics/ethnicity.get.summary
Этнический состав

# paths./api/v1/mapregion/demographics/ethnicity/{region_name}.get.summary
Этнический состав региона

# paths./api/v1/mapregion/economic/inflation.get.summary
Инфляция по регионам

# paths./api/v1/mapregion/economic/inflation/{region_name}.get.summary
Инфляция региона

# paths./api/v1/mapregion/economic/internet.get.summary
Интернет по регионам

# paths./api/v1/mapregion/economic/internet/{region_name}.get.summary
Интернет региона

# paths./api/v1/mapregion/strata.get.summary
Список страт

# paths./api/v1/mapregion/strata/matrix.get.summary
Матрица страт

# paths./api/v1/mapregion/strata/matrix/{region_name}.get.summary
Матрица страт региона

# paths./api/v1/mapregion/strata/{code}.get.summary
Страта по коду

# paths./api/v1/mapregion/regions/{region_id}/strata.get.summary
Страты региона по ID

# paths./api/v1/mapregion/regions/{region_name}/strata/summary.get.summary
Сводка страт региона

# paths./api/v1/mapregion/regions/by-group/{group}.get.summary
Регионы по группе

# paths./api/v1/mapregion/map/groups.get.summary
Сводка по группам

# paths./api/v1/mapregion/map/heatmap.get.summary
Тепловая карта

# paths./api/v1/mapregion/road-sections.get.summary
Участки дорог

# paths./api/v1/mapregion/road-sections/{section_id}.get.summary
Участок дороги по ID

# paths./api/v1/mapregion/regions/{region_name}/roads.get.summary
Дороги региона

# paths./api/v1/mapregion/reports/passport/{region_name}.get.summary
Паспорт региона (PDF)

# paths./api/v1/mapregion/reports/summary/{region_name}.get.summary
Аналитическая сводка

# paths./api/v1/mapregion/rol.get.summary
Список ROL-документов

# paths./api/v1/mapregion/rol/{stratum_code}.get.summary
ROL-документ по страте

# paths./api/v1/mapregion/rol/{stratum_code}.post.summary
Создать/обновить ROL

# paths./api/v1/mapregion/export/regions.get.summary
Экспорт регионов

# paths./api/v1/mapregion/export/timeseries.get.summary
Экспорт временных рядов

# paths./api/v1/mapregion/import/regions.post.summary
Импорт регионов

# paths./api/v1/mapregion/public/regions.get.summary
Публичные агрегированные данные MapRegion

# paths./api/v1/mapregion/public/regions.get.description
Return regional dashboard records without exposing the integration API.

# paths./api/v1/mapregion/public/regions-geojson.get.summary
Публичные границы MapRegion

# paths./api/v1/mapregion/public/regions-geojson.get.description
Return the public regional boundary projection consumed by Leaflet.

# paths./api/v1/mapregion/public/districts-geojson.get.summary
Публичные границы районов ADM2

# paths./api/v1/mapregion/public/districts-geojson.get.description
Return public ADM2 boundaries after the checked import gate has passed.

# paths./api/v1/mapregion/public/regions/compare.get.summary
Сравнение регионов MapRegion

# paths./api/v1/mapregion/public/regions/compare.get.description
Return a compact comparison projection for up to four selected regions.

# paths./api/v1/mapregion/public/regions/search.get.summary
Поиск регионов MapRegion

# paths./api/v1/mapregion/public/regions/search.get.description
Search only first-level regions in the public dashboard projection.

# paths./api/v1/mapregion/public/regions/indicators/ranges.get.summary
Диапазоны индикаторов MapRegion

# paths./api/v1/mapregion/public/regions/indicators/ranges.get.description
Expose only labels and observed numeric ranges for the UI filter.

# paths./api/v1/mapregion/public/regions/filter.get.summary
Фильтр регионов MapRegion

# paths./api/v1/mapregion/public/regions/filter.get.description
Filter regions by one approved public indicator.

# paths./api/v1/mapregion/public/regions/{region_name}/timeseries/{indic.get.summary
Публичный ряд показателя MapRegion

# paths./api/v1/mapregion/public/regions/{region_name}/timeseries/{indic.get.description
Return an official public time series; an empty row set is a valid response.

# paths./api/v1/mapregion/public/regions/{region_name}/poi-stats.get.summary
Публичная инфраструктурная сводка MapRegion

# paths./api/v1/mapregion/public/regions/{region_name}/poi-stats.get.description
Count public POI and settlements inside one region without sending raw POI to the browser.

# paths./api/v1/mapregion/public/poi/stats.get.description
Return small global counts for the POI panel badge labels.

# paths./api/v1/mapregion/public/poi/{kind}.get.description
Return a bounded, public GeoJSON overlay for on-demand map interaction.

# paths./api/v1/statistics/catalog.get.summary
Каталог официальных исторических показателей

# paths./api/v1/statistics/national.get.summary
Официальная статистика по Казахстану

# paths./api/v1/statistics/regions/{code}.get.summary
Официальная история показателей региона

# paths./api/v1/kz-data/catalog.get.summary
Каталог официальных источников Казахстана

# paths./api/v1/kz-data/national.get.summary
Национальные агрегаты Казахстана

# paths./api/v1/kz-data/regions.get.summary
Региональные агрегаты Казахстана

# paths./api/v1/kz-data/regions/{code}.get.summary
Агрегаты выбранного региона

# paths./api/v1/kz-data/nsdi.get.summary
Каталог слоёв Национальной инфраструктуры пространственных данных

# paths./api/v1/atlas/readiness.get.summary
Матрица наполнения QazGeo по ключевым направлениям

# paths./api/v1/atlas/readiness.get.description
Return the factual eight-track atlas coverage matrix.

# paths./api/v1/atlas/content-benchmark.get.summary
Бенчмарк наполнения и очередь обогащения QazGeo

# paths./api/v1/atlas/content-benchmark.get.description
Return metadata-only benchmark gaps and source gates for enrichment.

# paths./api/v1/atlas/enrichment-queue.get.summary
Единая очередь подключения данных QazGeo

# paths./api/v1/atlas/enrichment-queue.get.description
Return a single metadata-only queue assembled from all enrichment gates.

# paths./api/v1/atlas/enrichment-handoff.get.description
Return a metadata-only manifest for safe enrichment pipeline work.

# paths./api/v1/atlas/basemap-source-gate.get.summary
Кандидаты источников для базовой карты Казахстана

# paths./api/v1/atlas/basemap-source-gate.get.description
Return metadata-only basemap source candidates before any imports.

# paths./api/v1/atlas/statistics-enrichment-gate.get.summary
Очередь расширения официальной региональной статистики

# paths./api/v1/atlas/statistics-enrichment-gate.get.description
Return metadata-only gate for adding more official regional series.

# paths./api/v1/atlas/admin-boundaries.get.summary
Сводка административных границ ADM1/ADM2/КАТО

# paths./api/v1/atlas/admin-boundaries.get.description
Return current public administrative coverage and safe NSDI candidates.

# paths./api/v1/atlas/adm2-validation-gate.get.summary
Проверка допуска ADM2-геометрий

# paths./api/v1/atlas/adm2-validation-gate.get.description
Return the public ADM2 validation gate and publication status.

# paths./api/v1/atlas/environment-eo.get.summary
Сводка экологии, ЧС-сигналов и EO-продуктов

# paths./api/v1/atlas/environment-eo.get.description
Return the public operator contract for environment and EO coverage.

# paths./api/v1/atlas/ecology-source-gate.get.summary
Кандидаты источников для ecology-pack

# paths./api/v1/atlas/ecology-source-gate.get.description
Return metadata-only source candidates for ecology layers.

# paths./api/v1/atlas/eo-derivative-gate.get.summary
Очередь производных EO-продуктов

# paths./api/v1/atlas/eo-derivative-gate.get.description
Return metadata-only gates for computed EO products.

# paths./api/v1/atlas/emergency-ops.get.summary
Оперативная сводка ЧС-слоёв

# paths./api/v1/atlas/emergency-ops.get.description
Return 24h/7d/30d status windows for safe public Shadow layers.

# paths./api/v1/atlas/region-dossier/{code}.get.summary
Единое публичное досье территории

# paths./api/v1/atlas/region-dossier/{code}.get.description
Return a compact ADM1 dossier assembled from safe public contracts.

# paths./api/v1/tiles/sources.get.summary
Доступные источники векторных тайлов Martin

# paths./api/v1/tiles/sources.get.description
Return information about available tile sources.

In production, MapLibre connects to Martin via nginx at /tiles/.
This endpoint provides the catalog for frontend auto-discovery.

# paths./api/v1/tiles/sources.get.responses.200.content.application/json.schema.title
Response Tile Sources Api V1 Tiles Sources Get

# paths./ogc/.get.summary
Стартовая страница OGC API

# paths./ogc/conformance.get.summary
Декларация совместимости OGC

# paths./ogc/conformance.get.responses.200.content.application/json.schema.title
Response Conformance Ogc Conformance Get

# paths./ogc/collections.get.summary
Список коллекций объектов

# paths./ogc/collections.get.responses.200.content.application/json.schema.title
Response List Collections Ogc Collections Get

# paths./ogc/collections/{collection_id}.get.summary
Метаданные коллекции

# paths./ogc/collections/{collection_id}.get.responses.200.content.application/json.schema.title
Response Get Collection Ogc Collections  Collection Id  Get

# paths./ogc/collections/{collection_id}/items.get.summary
Объекты коллекции в GeoJSON

# paths./ogc/collections/{collection_id}/items.get.responses.200.content.application/json.schema.title
Response Get Items Ogc Collections  Collection Id  Items Get

# paths./ogc/collections/{collection_id}/items/{feature_id}.get.summary
Один объект коллекции

# paths./ogc/collections/{collection_id}/items/{feature_id}.get.responses.200.content.application/json.schema.title
Response Get Item Ogc Collections  Collection Id  Items  Feature Id  Get

# paths./api/v1/h3/hexbin.get.summary
H3-агрегация точек по шестиугольной сетке

# paths./api/v1/h3/hexbin.get.description
Aggregate point data into H3 hexagonal bins.

Returns a GeoJSON FeatureCollection where each feature is a hexagonal polygon
with a `count` property indicating how many points fall into that cell.

**Resolution guide:**
- 3: ~12,393 km² per hex (country overview)
- 5: ~252 km² (oblast level)
- 7: ~5.16 km² (city level, default)
- 9: ~0.105 km² (neighborhood level, max allowed)

# paths./api/v1/h3/cell.get.summary
H3-ячейка для координаты

# paths./api/v1/h3/cell.get.description
Return the H3 cell index and boundary polygon for a given coordinate.

# paths./api/v1/h3/cell.get.responses.200.content.application/json.schema.title
Response Cell For Point Api V1 H3 Cell Get

# paths./api/v1/photon/search.get.summary
Поиск адреса и объекта через Photon/OSM

# paths./api/v1/photon/search.get.description
Search for places using Photon autocomplete geocoder (powered by OSM data).

Supports search-as-you-type for fast UI integration.
Results are GeoJSON features with OSM properties.

**Kazakhstan bias**: Center coordinates default to Kazakhstan center for relevance.

# paths./api/v1/photon/search.get.parameters[].schema.description
OSM tag filter: place:city, amenity:hospital

# paths./api/v1/photon/search.get.parameters[].description
OSM tag filter: place:city, amenity:hospital

# paths./api/v1/photon/search.get.responses.200.content.application/json.schema.title
Response Search Api V1 Photon Search Get

# paths./api/v1/photon/reverse.get.summary
Обратное геокодирование через Photon

# paths./api/v1/photon/reverse.get.description
Reverse geocode: coordinates → address using Photon OSM data.

# paths./api/v1/photon/reverse.get.responses.200.content.application/json.schema.title
Response Reverse Api V1 Photon Reverse Get

# paths./api/v1/photon/health.get.summary
Проверка доступности Photon

# paths./api/v1/photon/health.get.description
Check if the Photon geocoder sidecar is running.

# paths./api/v1/photon/health.get.responses.200.content.application/json.schema.title
Response Health Api V1 Photon Health Get

# paths./api/v1/layers.get.description
Return the public layer registry for map clients.

# paths./api/v1/layers/{layer_id}.get.summary
Описание одного слоя

# paths./api/v1/layers/{layer_id}.get.description
Return a single layer definition by registry id.

# paths./api/v1/layers/{layer_id}.get.responses.200.content.application/json.schema.title
Response Get Layer Api V1 Layers  Layer Id  Get

# paths./api/v1/external-layers/shadow-events.get.summary
Публичные события QazLake Shadow как GeoJSON

# paths./api/v1/external-layers/shadow-events.get.description
Serve only the public environmental/event subset of Shadow observations.

# paths./api/v1/external-layers/shadow-coverage.get.summary
Свежесть публичного слоя QazLake Shadow

# paths./api/v1/external-layers/shadow-coverage.get.description
Expose only coverage and freshness for the vetted external layer.

# paths./api/v1/external-layers/satellite-products.get.summary
Проверенный каталог спутниковых продуктов QazLake

# paths./api/v1/external-layers/satellite-products.get.description
Expose product metadata only; raw imagery and storage paths stay internal.

# paths./api/v1/external-layers/regional-indicators.get.summary
Проверенные текущие показатели регионов

# paths./api/v1/external-layers/regional-indicators.get.description
Expose only the complete three-metric, 20-region QazLake snapshot.

# paths./api/v1/external-layers/national-macro.get.summary
Проверенные национальные макропоказатели

# paths./api/v1/external-layers/national-macro.get.description
Return a compact national context, never a substitute for a regional layer.

# paths./api/v1/external-layers/sar-scenes.get.summary
Свежие сцены Sentinel-1 над Казахстаном

# paths./api/v1/external-layers/sar-scenes.get.description
Expose recent Sentinel-1 scene centres, never imagery or raw payloads.

# paths./api/v1/external-layers/nasa-viirs-true-color.get.summary
Актуальный снимок NASA VIIRS как TileJSON

# paths./api/v1/external-layers/nasa-viirs-true-color.get.description
Return a no-key NASA GIBS raster contract; QazGeo does not proxy pixels.

# paths./api/v1/external-layers/hydro-stations.get.summary
Гидропосты Казахстана из нормализованного QazLake

# paths./api/v1/external-layers/hydro-stations.get.description
Expose active hydrology stations through a viewport-bounded public contract.

# paths./api/v1/external-layers/water-objects.get.summary
Водные объекты Казахстана из нормализованного QazLake

# paths./api/v1/external-layers/water-objects.get.description
Expose a viewport-bounded water catalogue without raw OSM tags or IDs.

# paths./records.get.summary
Стартовая страница каталога записей

# paths./records/collections.get.summary
Список публичных каталогов записей

# paths./records/collections/qazgeo/items.get.summary
Поиск публичных записей QazGeo

# paths./records/collections/qazgeo/items/{record_id}.get.summary
Публичная запись QazGeo

# paths./stac.get.summary
Стартовая страница STAC

# paths./stac/collections.get.summary
Список коллекций STAC

# paths./stac/conformance.get.summary
Декларация совместимости STAC

# paths./stac/collections/{collection_id}.get.summary
Карточка коллекции STAC

# paths./stac/collections/{collection_id}/items.get.summary
Объекты коллекции STAC

# paths./stac/search.get.summary
Поиск метаданных Sentinel-1

# paths./stac/search.post.summary
Поиск метаданных Sentinel-1 по STAC-запросу

# paths./health.get.description
Compatibility diagnostics endpoint used by existing consumers.

# paths./health/live.get.description
Dependency-free liveness probe for Docker and process supervisors.

# paths./health/ready.get.description
Readiness probe: dependencies are available for serving data endpoints.