api.automapa.comv3 - all systems normal

Batch geocode

Geocoder.geocodemulti

Geocode up to 100 structured addresses in one request. Each address requires city; results follow input order.

POST/v3/Geocoder/geocodemultiapi.automapa.com

Body parameters

BodyTypeDescription
addressesobject[] REQUIREDProvide up to 100 address objects, each with city. Other geocode field rules apply; results follow input order.
countrystringOptional country code. Omitted or null defaults to PL; an empty value remains empty. Use uppercase PL for Polish addresses. International geocoding requires access to international coverage.
provincestringOptional province name; no value is filled in automatically.
districtstringOptional. Missing or null defaults to an empty string.
communitystringOptional. Missing or null defaults to an empty string.
citystring REQUIREDRequired city name for every address, including PL.
quarterstringOptional. Missing or null defaults to an empty string.
pcodestringOptional. Missing or null defaults to an empty string.
streetstringOptional. Missing or null defaults to an empty string.
housestringOptional. Missing or null defaults to an empty string.
maxResultintegerFor PL addresses, maximum matches per address: 1–3 (default 1). Values outside this range are limited to 1–3. Set maxResult in each address; maxResults does not set this limit.

Example request

{
    "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"
        }
    ]
}

Example response

{
    "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"
            }
        ]
    ]
}

The example shows a batch response whose result entries preserve request order. Actual coordinates and postal-code data depend on each input address and current map data; each address can return a different number of matches up to maxResult.

result fields

result fieldsTypeDescription
qualityintegerGeocoding quality score.
xdoubleLongitude (WGS84).
ydoubleLatitude (WGS84).
countrystringCountry code.
provincestringProvince.
districtstringDistrict (powiat).
communitystringCommunity (gmina).
citystringCity.
quarterstringQuarter.
pcodestringPostal code (PL only).
streetstringStreet.
housestringHouse number.
addressTypeinteger EXTENDEDBuilding type. Extended.
peoplesForAddressinteger EXTENDEDResidents at address. Extended.
flatsForAddressinteger EXTENDEDFlats at address. Extended.
buildingsForAddressinteger EXTENDEDBuildings at address. Extended.
pcodeExtraInfoobject[] EXTENDEDExtra postal-code info. Extended.
resultRadiusnumberResult envelope radius (m). -1 if unknown.
mapLinkstringLink to map result.