Геометрія територій

Параметри URL

countrystringОбов’язковий

Дволітерний код ISO 3166-1 alpha-2 у нижньому регістрі. Використовуйте поле code зі списку країн.

Запит і відповідь

Передайте API-ключ у заголовку Authorization. Параметри запиту та тіло не потрібні. Успішна відповідь має статус 200 і тип вмісту application/geo+json. Об’єкт FeatureCollection можна передати до бібліотеки, що підтримує GeoJSON, без додаткової обгортки data.

Атрибути відповіді

typestring

Тип об’єкта GeoJSON. Завжди FeatureCollection.

featuresarray<object>

Адміністративні одиниці верхнього рівня. Кожен елемент є об’єктом Feature.

Атрибути елемента масиву

typestring

Тип об’єкта GeoJSON. Завжди Feature.

propertiesobject

Атрибути території.

Атрибути об’єкта

countrystring

Код країни з параметра URL.

katottgstring

Код адміністративної одиниці. Пов’язує геометрію з територією в ATU.

full_namestring | null

Повна назва території. null, якщо назва відсутня.

geometryobject | null

Геометрія меж території. null означає, що геометрія відсутня; це не ознака відсутності самої території.

Атрибути об’єкта

typestring

Тип геометрії: Polygon або MultiPolygon.

coordinatesarray

Координати WGS 84 у десяткових градусах, у порядку [довгота, широта]. Для Polygon це масив кілець; для MultiPolygon це масив полігонів. Перше кільце задає зовнішню межу, наступні кільця задають отвори. Перша й остання позиції кільця збігаються.

Помилки запиту

Невідома країна повертає 404, недоступні дані країни повертають 409, неправильний формат коду повертає 422. При 401 перевірте API-ключ, при 429 зачекайте час із Retry-After.