api.automapa.comv3 - усі системи працюють

Геокодувати адресу

Geocoder.geocode

Перетворює структуровану адресу з обов’язковим полем city на координати й дані відповідного адресного запису.

POST/v3/Geocoder/geocodeapi.automapa.com

Параметри body

Тіло запитуТипОпис
addressobject ОБОВ’ЯЗКОВЕПередайте об’єкт адреси з обов’язковим полем city. Інші поля необов’язкові; вкажіть достатньо даних для пошуку збігу.
countrystringНеобов’язковий код країни. Відсутнє або null означає PL; порожнє значення лишається порожнім. Для польських адрес використовуйте PL великими літерами. Міжнародне геокодування потребує відповідного доступу.
provincestringНеобов’язкова назва воєводства; автоматично не заповнюється.
districtstringНеобов’язкове. Відсутнє або null дає порожній рядок.
communitystringНеобов’язкове. Відсутнє або null дає порожній рядок.
citystring ОБОВ’ЯЗКОВЕНазва міста city обов’язкова в кожній адресі, зокрема для PL.
quarterstringНеобов’язкове. Відсутнє або null дає порожній рядок.
pcodestringНеобов’язкове. Відсутнє або null дає порожній рядок.
streetstringНеобов’язкове. Відсутнє або null дає порожній рядок.
housestringНеобов’язкове. Відсутнє або null дає порожній рядок.
maxResultintegerДля польських адрес не більш ніж 1–3 збіги на адресу (типово 1). Значення поза діапазоном обмежуються до 1–3. Задайте maxResult у кожній адресі; maxResults не задає цей ліміт.

Приклад запиту

{
    "address": {
        "country": "PL",
        "city": "Warszawa",
        "street": "Domaniewska",
        "house": "37"
    }
}

Приклад відповіді

{
    "result": [
        {
            "quality": 9,
            "x": 21.0071318,
            "y": 52.18284,
            "country": "PL",
            "province": "mazowieckie",
            "district": "Warszawa",
            "community": "Warszawa",
            "city": "Warszawa",
            "quarter": "Mokotów",
            "pcode": "02-672",
            "street": "Domaniewska",
            "house": "37",
            "resultRadius": 0,
            "flat": ""
        }
    ]
}

Приклад показує вибрані поля відповіді. Фактичні координати й поштові дані залежать від вхідних даних та актуальних картографічних даних; також можуть бути присутні розширені поля, доступні за окремими дозволами.

поля result

поля resultТипОпис
qualityintegerGeocoding quality score.
xdoubleLongitude (WGS84).
ydoubleLatitude (WGS84).
countrystringCountry code.
provincestringProvince.
districtstringDistrict (powiat).
communitystringCommunity (gmina).
citystringCity.
quarterstringQuarter.
pcodestringPostal code (PL only).
streetstringStreet.
housestringHouse number.
addressTypeinteger РОЗШИРЕНЕBuilding type. Extended.
peoplesForAddressinteger РОЗШИРЕНЕResidents at address. Extended.
flatsForAddressinteger РОЗШИРЕНЕFlats at address. Extended.
buildingsForAddressinteger РОЗШИРЕНЕBuildings at address. Extended.
pcodeExtraInfoobject[] РОЗШИРЕНЕExtra postal-code info. Extended.
resultRadiusnumberResult envelope radius (m). -1 if unknown.
mapLinkstringLink to map result.