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

Szukaj miejsc i POI

Autocomplete.search

Wyszukiwanie tekstowe po miastach, ulicach, adresach i punktach POI.

POST/v3/Autocomplete/searchapi.automapa.com

Parametry body

Treść żądaniaTypOpis
querystring WYMAGANEFraza wyszukiwania obejmująca miejscowości, ulice, adresy lub punkty POI.
typesstring[]Ogranicza wyniki do "place", "poi" albo obu typów; domyślnie zwracane są oba.

Przykładowe żądanie

{
    "query": "Warszawa Domaniewska 37"
}

Przykładowa odpowiedź

{
    "result": {
        "items": [
            {
                "type": "place",
                "subtype": "building",
                "name": "Domaniewska 37, 02-672 Warszawa",
                "province": "mazowieckie",
                "place": "Warszawa",
                "quarter": "Mokotów",
                "street": "Domaniewska",
                "number": "37",
                "postal_code": "02-672",
                "coords": {
                    "x": 21.0071318,
                    "y": 52.18284
                }
            },
            {
                "type": "place",
                "subtype": "building",
                "name": "Domaniewska 37A, 02-672 Warszawa",
                "place": "Warszawa",
                "street": "Domaniewska",
                "number": "37A",
                "postal_code": "02-672",
                "coords": {
                    "x": 21.0070156,
                    "y": 52.18238
                }
            }
        ]
    }
}

pola result

pola resultTypOpis
items[].typestringTyp wyniku: place albo poi.
items[].subtypestringSzczegółowy typ wyniku: kategoria POI albo typ place, street lub building.
items[].namestringCzytelna nazwa wyniku przeznaczona do wyświetlenia.
items[].provincestringNazwa województwa lub regionu przypisanego do wyniku.
items[].districtstringNazwa powiatu lub jednostki odpowiadającej district.
items[].communitystringNazwa gminy lub jednostki odpowiadającej community.
items[].placestringNazwa miejscowości przypisanej do wyniku.
items[].quarterstringNazwa dzielnicy przypisanej do wyniku.
items[].streetstringNazwa ulicy przypisanej do wyniku.
items[].numberstringNumer budynku.
items[].postal_codestringKod pocztowy.
items[].coordsobjectObiekt { x, y }, gdzie x oznacza długość, a y szerokość geograficzną.