api.automapa.comv3 - wszystkie systemy działają

Geokodowanie wsadowe

Geocoder.geocodemulti

Geokoduje do 100 adresów strukturalnych w jednym żądaniu. Każdy wymaga pola city; wyniki zachowują kolejność wejściową.

POST/v3/Geocoder/geocodemultiapi.automapa.com

Parametry body

Treść żądaniaTypOpis
addressesobject[] WYMAGANEPodaj do 100 obiektów adresowych, każdy z wymaganym polem city. Pozostałe zasady pól geocode obowiązują; wyniki zachowują kolejność wejściową.
countrystringOpcjonalny kod kraju. Brak lub null oznacza PL; pusta wartość pozostaje pusta. Dla adresów w Polsce użyj wielkich liter PL. Geokodowanie międzynarodowe wymaga odpowiedniego dostępu.
provincestringOpcjonalna nazwa województwa; API nie uzupełnia jej automatycznie.
districtstringPole opcjonalne; brak lub null ustawia domyślnie pusty ciąg.
communitystringPole opcjonalne; brak lub null ustawia domyślnie pusty ciąg.
citystring WYMAGANEWymagana nazwa miejscowości w każdym adresie, także dla PL.
quarterstringPole opcjonalne; brak lub null ustawia domyślnie pusty ciąg.
pcodestringPole opcjonalne; brak lub null ustawia domyślnie pusty ciąg.
streetstringPole opcjonalne; brak lub null ustawia domyślnie pusty ciąg.
housestringPole opcjonalne; brak lub null ustawia domyślnie pusty ciąg.
maxResultintegerDla adresów w Polsce maksymalnie 1–3 dopasowania na adres (domyślnie 1). Wartości spoza zakresu są ograniczane do 1–3. Ustaw maxResult w każdym adresie; maxResults nie ustawia tego limitu.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykład pokazuje odpowiedź wsadową, w której elementy result zachowują kolejność żądania. Rzeczywiste współrzędne i dane kodu pocztowego zależą od każdego adresu wejściowego oraz aktualnych danych mapowych; każdy adres może zwrócić inną liczbę dopasowań, nie większą niż maxResult.

pola result

pola resultTypOpis
qualityintegerOcena jakości dopasowania geokodowania w skali opisanej w przewodniku jakości.
xdoubleDługość geograficzna w układzie WGS84.
ydoubleSzerokość geograficzna w układzie WGS84.
countrystringKod kraju przypisany do wyniku.
provincestringNazwa województwa lub regionu przypisanego do wyniku.
districtstringNazwa powiatu przypisanego do wyniku.
communitystringNazwa gminy przypisanej do wyniku.
citystringNazwa miejscowości przypisanej do wyniku.
quarterstringNazwa dzielnicy przypisanej do wyniku.
pcodestringKod pocztowy; pole dostępne dla wyników w Polsce.
streetstringNazwa ulicy przypisanej do wyniku.
housestringNumer budynku.
addressTypeinteger ROZSZERZONETyp budynku; pole rozszerzone zależne od uprawnień.
peoplesForAddressinteger ROZSZERZONELiczba mieszkańców przypisana do adresu; pole rozszerzone zależne od uprawnień.
flatsForAddressinteger ROZSZERZONELiczba lokali mieszkalnych przypisana do adresu; pole rozszerzone zależne od uprawnień.
buildingsForAddressinteger ROZSZERZONELiczba budynków przypisana do adresu; pole rozszerzone zależne od uprawnień.
pcodeExtraInfoobject[] ROZSZERZONEDodatkowe informacje o kodzie pocztowym; pole rozszerzone zależne od uprawnień.
resultRadiusnumberPromień otoczki wyniku w metrach; -1 oznacza, że promień jest nieznany.
mapLinkstringAdres URL mapy pokazującej lokalizację wyniku.