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.