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.