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

Параметри URL

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

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

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

Код адміністративної одиниці зі списку територій вибраної країни.

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

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

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

typestring

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

propertiesobject

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

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

countrystring

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

katottgstring

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

full_namestring | null

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

geometryobject | null

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

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

typestring

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

coordinatesarray

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

Відсутні дані та помилки

Якщо територія існує, але її геометрія відсутня, метод повертає 200 з geometry: null. Невідома країна або територія повертає 404. Недоступні дані країни повертають 409, некоректні параметри повертають 422. При 401 перевірте API-ключ, при 429 зачекайте час із Retry-After.