api.automapa.comv3 - все системы работают

Пакетное геокодирование

Geocoder.geocodemulti

Геокодирует до 100 структурированных адресов за запрос. Каждый требует city; результаты сохраняют порядок ввода.

POST/v3/Geocoder/geocodemultiapi.automapa.com

Параметры body

Тело запросаТипОписание
addressesobject[] ОБЯЗАТЕЛЬНОПередайте до 100 объектов адресов, каждый с обязательным полем city. Действуют остальные правила полей geocode; результаты сохраняют порядок ввода.
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 не задает этот предел.

Пример запроса

{
    "addresses": [
        {
            "country": "PL",
            "city": "Warszawa",
            "street": "Domaniewska",
            "house": "37"
        },
        {
            "country": "PL",
            "city": "afdsgsd",
            "street": "asdfsdf",
            "house": "1"
        },
        {
            "country": "PL",
            "city": "Rumia",
            "street": "Grunwaldzka",
            "house": "2",
            "pcode": "84-230"
        }
    ]
}

Пример ответа

{
    "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": ""
            }
        ],
        {
            "status": "ERROR",
            "message": "Unknown address"
        },
        [
            {
                "quality": 9,
                "x": 18.3865894,
                "y": 54.57206,
                "country": "PL",
                "city": "Rumia",
                "street": "Grunwaldzka",
                "house": "2",
                "pcode": "84-230"
            }
        ]
    ]
}

Пример показывает пакетный ответ, в котором элементы result сохраняют порядок запроса. Фактические координаты и почтовые данные зависят от каждого входного адреса и актуальных картографических данных; каждый адрес может вернуть разное число совпадений в пределах maxResult.

поля 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.