Search - Get Geocode Autocomplete

Usługa:: Maps

Wersja interfejsu API:: 2026-01-01

Umożliwia pobranie listy rankingowej sugerowanych encji na podstawie lokalizacji użytkownika i częściowego zapytania.
Dla żądania z lokalizacją użytkownika oraz częściowego zapytania służącego jako prefiks pełnego ciągu zapytania (zwanego prefiksem zapytania), API Azure Maps Autocomplete zwraca listę sugerowanych bytów, których użytkownik najprawdopodobniej szuka. Podmioty te są uszeregowane od najbardziej do najmniej prawdopodobnych.

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}

Z parametrami opcjonalnymi:

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}&coordinates={coordinates}&bbox={bbox}&top={top}&resultTypeGroups={resultTypeGroups}&resultTypes={resultTypes}&view={view}&countryRegion={countryRegion}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
query	query	True	string	To jest wymagane. Prefiks zapytania użytkownika. Przykład: "1 Micro" lub "Muir Woods".
bbox	query		number[]	Wymagane, gdy `coordinates` nie jest podany. Prostokątny obszar na ziemi zdefiniowany jako obiekt pola ograniczenia. Boki prostokąta są definiowane przez wartości długości i szerokości geograficznej. Po określeniu tego parametru obszar geograficzny jest brany pod uwagę przy obliczaniu wyników kwerendy dotyczącej lokalizacji. Przykład: lon1,lat1,lon2,lat2. Minimalny rozmiar: około 0,00001 stopnia (~0,01 metra). Maksymalny rozmiar: do pełnego globalnego zasięgu (od -180,-90 do 180,90)
coordinates	query		number[]	Wymagane, gdy `bbox` nie jest podany. Punkt na Ziemi określony jako długość i szerokość geograficzna. Po określeniu tego parametru lokalizacja użytkownika jest brana pod uwagę, a zwrócone wyniki mogą być bardziej odpowiednie dla użytkownika. Przykład: współrzędne &=lon,lat Nuta:`coordinates` staje się sygnałem wtórnym, jeśli `bbox` jest podany.
countryRegion	query		string	Sygnał dla wyniku autouzupełniania do kodu regionu/kraju ISO 3166-1 Alpha-2 , który jest określony, np. FR. Zostaną zwrócone tylko wyniki w określonym kraju/regionie.
resultTypeGroups	query		AutocompleteResultTypeGroupsEnum[]	Rozdzielona przecinkami lista zwracanych grup typów jednostek. Możliwe wartości to Address Miejsce
resultTypes	query		AutocompleteResultTypeEnum[]	Rozdzielona przecinkami lista zwracanych typów jednostek. Gdy grupa typów jest ustawiona na Adres, obsługiwane typy to: Address Blokada Wszystkie inne typy należą do grupy Typ miejsca. Mogą to być jednostki, takie jak AdminDivision1, Neighborhood, PopulatedPlace i inne. Wartość domyślna to wszystkie możliwe typy jednostek.
top	query		integer (int32) minimum: 1 maximum: 20	Maksymalna liczba odpowiedzi, które zostaną zwrócone. Domyślnie: 5, minimum: 1 i maksimum: 20.
view	query		string	Ciąg reprezentujący kod ISO 3166-1 Alfa-2 w regionie/kraju. Spowoduje to zmianę spornych geopolitycznych granic i etykiet w celu dopasowania ich do określonego regionu użytkownika. Domyślnie parametr Widok jest ustawiony na wartość "Auto", nawet jeśli nie zdefiniowano go w żądaniu. Aby uzyskać szczegółowe informacje, zobacz Obsługiwane widoki, aby uzyskać szczegółowe informacje i wyświetlić dostępne widoki.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-id		string	Określa, które konto jest przeznaczone do użycia w połączeniu z modelem bezpieczeństwa Azure AD. Reprezentuje unikalny identyfikator dla konta Azure Maps i można go pobrać z API konta Azure Maps management plane. Więcej informacji na temat korzystania z Microsoft Entra ID zabezpieczeń w Azure Maps można znaleźć w Manage authentication in Azure Maps.
Accept-Language		string	Język, w którym powinny być zwracane wyniki wyszukiwania. Aby uzyskać szczegółowe informacje, zobacz Obsługiwane języki.

Nazwa

Wymagane

Typ

Opis

x-ms-client-id

string

Określa, które konto jest przeznaczone do użycia w połączeniu z modelem bezpieczeństwa Azure AD. Reprezentuje unikalny identyfikator dla konta Azure Maps i można go pobrać z API konta Azure Maps management plane. Więcej informacji na temat korzystania z Microsoft Entra ID zabezpieczeń w Azure Maps można znaleźć w Manage authentication in Azure Maps.

Accept-Language

string

Język, w którym powinny być zwracane wyniki wyszukiwania.

Aby uzyskać szczegółowe informacje, zobacz Obsługiwane języki.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AutocompleteResponse	Żądanie zakończyło się pomyślnie. Media Types: "application/geo+json", "application/json"
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Media Types: "application/geo+json", "application/json" Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

200 OK

AutocompleteResponse

Żądanie zakończyło się pomyślnie.

Media Types: "application/geo+json", "application/json"

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Media Types: "application/geo+json", "application/json"

Nagłówki

x-ms-error-code: string

Zabezpieczenia

AadToken

Są to przepływy Microsoft Entra OAuth 2.0. W połączeniu z Azure zarządzaniem dostępem opartym na rolach może być używany do kontroli dostępu do Azure Maps API REST. Kontrola dostępu oparta na rolach Azure służy do wyznaczania dostępu do jednego lub więcej kont zasobów lub podzasobów Azure Maps. Każdy użytkownik, grupa lub podmiot usługowy może otrzymać dostęp poprzez wbudowaną rolę lub niestandardową rolę składającą się z jednego lub więcej uprawnień do Azure Maps API REST.\n\nAby zaimplementować scenariusze, zalecamy zapoznanie się z koncepcjami authentication concepts. Podsumowując, ta definicja bezpieczeństwa zapewnia rozwiązanie do modelowania aplikacji(-ów) za pomocą obiektów zdolnych do kontroli dostępu do określonych API i zakresów.\n\n#### Uwagi\n* Ta definicja bezpieczeństwa wymaga użycia nagłówka x-ms-client-id do wskazania, do którego Azure Maps zasobu aplikacja żąda dostępu. Można ją uzyskać z API zarządzania Maps.\n* \nAuthorization URL jest specyficzny dla instancji Azure chmury publicznej. Suwerenne chmury mają unikalne adresy URL autoryzacji oraz konfiguracje Microsoft Entra ID. \n* \nKontrola dostępu oparta na rolach Azure jest konfigurowana z płaszczyzny zarządzania Azure za pośrednictwem Azure portalu, PowerShell, CLI, Azure SDKs lub API REST.\n* \nWykorzystanie Azure Maps Web SDK umożliwia konfigurację aplikacji dla wielu zastosowań.\n* Aby uzyskać więcej informacji o Platforma tożsamości Microsoft, zobacz przegląd Platforma tożsamości Microsoft przegląd.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://atlas.microsoft.com/.default

subscription-key

Jest to klucz współdzielony, który jest przydzielany podczas Tworzenia konta Azure Maps w portalu Azure lub za pomocą PowerShell, CLI, Azure SDKs lub REST API.\n\n Dzięki temu kluczowi każda aplikacja może uzyskać dostęp do wszystkich API REST. Innymi słowy, ten klucz może być używany jako klucz główny na koncie, na którym są wydawane.\n\n W przypadku aplikacji udostępnionych publicznie zalecamy stosowanie podejścia confidential client applications do dostępu do API REST Azure Maps i bezpiecznie przechowywać klucz.

Typ: apiKey
W: header

SAS Token

Jest to token podpisu współdzielonego dostępu tworzony na podstawie operacji List SAS na Azure Maps resource przez płaszczyznę zarządzania Azure za pomocą Azure portalu, PowerShell, CLI, Azure SDKs lub API REST.\n\n Dzięki temu tokenowi każda aplikacja jest autoryzowana do dostępu za pomocą Azure kontrola dostępu oparta na rolach oraz precyzyjna kontrola do terminu wygaśnięcia, tempa i regionu użycia danego tokena. Innymi słowy, token SAS może być używany do umożliwienia aplikacjom kontrolowania dostępu w sposób bezpieczniejszy niż klucz współdzielony.\n\n W przypadku aplikacji udostępnionych publicznie zalecamy skonfigurowanie konkretnej listy dozwolonych źródeł na zasobach konta Map , aby ograniczyć nadużycia renderowania i regularnie odnawiać Token SAS.

Typ: apiKey
W: header

Przykłady

Autocomplete API call to search for '1 Microsoft'

Autocomplete API call to search for '1 Microsoft Way, Redmond', filtered by roadblock resultTypes, place resultTypeGroups, and return empty result

Autocomplete API call to search for 'Muir Woods', filtered by address resultTypeGroups

Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups

Autocomplete API call to search for 'Muir Woods', filtered by park resultTypes

Autocomplete API call to search for 'Muir Woods', filtered by place resultTypeGroups

Autocomplete API call to search for 'Muir Woods', filtered by roadblock resultTypes, address resultTypeGroups

Autocomplete API call to search for '1 Microsoft'

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft&coordinates=-113.301894,49.201888

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Address",
        "type": "Address",
        "address": {
          "streetNumber": "1",
          "streetName": "Microsoft Way",
          "addressLine": "1 Microsoft Way",
          "locality": "Redmond",
          "adminDistricts": [
            {
              "name": "Washington"
            },
            {
              "name": "King County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "postalCode": "98052",
          "formattedAddress": "1 Microsoft Way, Redmond, Washington 98052, United States"
        }
      }
    },
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "LandmarkBuilding",
        "address": {
          "locality": "Bellevue",
          "adminDistricts": [
            {
              "name": "Washington"
            },
            {
              "name": "King County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "formattedAddress": "Bellevue, Washington, United States"
        },
        "name": "Microsoft-Advanta C"
      }
    }
  ]
}

Autocomplete API call to search for '1 Microsoft Way, Redmond', filtered by roadblock resultTypes, place resultTypeGroups, and return empty result

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft Way, Redmond&coordinates=-113.301894,49.201888&resultTypeGroups=Place&resultTypes=RoadBlock

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": []
}

Autocomplete API call to search for 'Muir Woods', filtered by address resultTypeGroups

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Address",
        "type": "Address",
        "address": {
          "streetName": "Muir Woods Rd",
          "addressLine": " Muir Woods Rd",
          "locality": "Sausalito",
          "adminDistricts": [
            {
              "name": "California"
            },
            {
              "name": "Marin County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "postalCode": "94965",
          "formattedAddress": "Muir Woods Rd, Sausalito, California 94965, United States"
        }
      }
    },
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Address",
        "type": "RoadBlock",
        "address": {
          "streetName": "Muir St",
          "addressLine": " Muir St",
          "locality": "Grosse Pointe Farms",
          "adminDistricts": [
            {
              "name": "Michigan"
            },
            {
              "name": "Wayne County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "postalCode": "48236",
          "formattedAddress": "Muir St, Grosse Pointe Farms, Michigan 48236, United States"
        }
      }
    }
  ]
}

Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place&resultTypes=Park,PopulatedPlace

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "PopulatedPlace",
        "address": {
          "locality": "Muir Woods",
          "adminDistricts": [
            {
              "name": "Georgia"
            },
            {
              "name": "Fulton County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "postalCode": "30349",
          "formattedAddress": "Muir Woods, Georgia 30349, United States"
        }
      }
    },
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "Park",
        "address": {
          "adminDistricts": [
            {
              "name": "California"
            },
            {
              "name": "Marin County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "formattedAddress": "California"
        },
        "name": "Muir Woods National Park"
      }
    }
  ]
}

Autocomplete API call to search for 'Muir Woods', filtered by park resultTypes

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypes=Park

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "Park",
        "address": {
          "adminDistricts": [
            {
              "name": "California"
            },
            {
              "name": "Marin County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "formattedAddress": "California"
        },
        "name": "Muir Woods National Monument"
      }
    }
  ]
}

Autocomplete API call to search for 'Muir Woods', filtered by place resultTypeGroups

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "Forest",
        "address": {
          "adminDistricts": [
            {
              "name": "Wisconsin"
            },
            {
              "name": "Dane County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "formattedAddress": "Wisconsin"
        },
        "name": "Muir Woods"
      }
    },
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "PopulatedPlace",
        "address": {
          "locality": "Muir Woods",
          "adminDistricts": [
            {
              "name": "Georgia"
            },
            {
              "name": "Fulton County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "postalCode": "30349",
          "formattedAddress": "Muir Woods, Georgia 30349, United States"
        }
      }
    },
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Place",
        "type": "Park",
        "address": {
          "adminDistricts": [
            {
              "name": "California"
            },
            {
              "name": "Marin County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "formattedAddress": "California"
        },
        "name": "Muir Woods National Monument"
      }
    }
  ]
}

Autocomplete API call to search for 'Muir Woods', filtered by roadblock resultTypes, address resultTypeGroups

Przykładowe żądanie

HTTP

GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address&resultTypes=RoadBlock

Przykładowa odpowiedź

Kod stanu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "typeGroup": "Address",
        "type": "RoadBlock",
        "address": {
          "streetName": "Muir St",
          "addressLine": " Muir St",
          "locality": "Grosse Pointe Farms",
          "adminDistricts": [
            {
              "name": "Michigan"
            },
            {
              "name": "Wayne County"
            }
          ],
          "countryRegion": {
            "ISO": "US",
            "name": "United States"
          },
          "postalCode": "48236",
          "formattedAddress": "Muir St, Grosse Pointe Farms, Michigan 48236, United States"
        }
      }
    }
  ]
}

Definicje

Nazwa	Opis
Address	Adres wyniku
AddressAdminDistrictsItem	Nazwa poddziału w kraju lub regionie dla adresu.
AddressCountryRegion	Kraj lub region wraz z jego nazwą i kodem ISO.
AutocompleteFeature	Funkcje autouzupełniania wyników
AutocompleteProperties	Właściwości wyniku autouzupełniania
AutocompleteResponse	Ten obiekt jest zwracany po pomyślnym wywołaniu autouzupełniania.
AutocompleteResultTypeEnum	Rodzaj sugestii
AutocompleteResultTypeGroupsEnum	Adres lub miejsce
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.
FeatureCollectionEnum	Określa typ `GeoJSON`. Jedynym obsługiwanym typem obiektu jest `FeatureCollection`. Aby uzyskać więcej informacji, zobacz RFC 7946.
FeatureTypeEnum	Typ funkcji musi mieć wartość Funkcja.
GeoJsonObjectType	Określa typ `GeoJSON`. Musi być jednym z dziewięciu prawidłowych typów obiektów GeoJSON — Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature i FeatureCollection.
GeoJsonPoint	Prawidłowy typ geometrii `GeoJSON Point`. Aby uzyskać szczegółowe informacje, zobacz RFC 7946.
Intersection	Adres wyniku.

Address

Objekt

Adres wyniku

Nazwa	Typ	Opis
addressLine	string	AddressLine, który zawiera nazwę ulicy i numer
adminDistricts	AddressAdminDistrictsItem[]	Nazwa poddziału w kraju lub regionie dla adresu. Ten element jest zwykle traktowany jako podsieć administracyjna pierwszego zamówienia, ale w niektórych przypadkach zawiera również drugą, trzecią lub czwartą podział kolejności w kraju, zależności lub regionie.
countryRegion	AddressCountryRegion	Kraj lub region wraz z jego nazwą i kodem ISO.
formattedAddress	string	Właściwość Sformatowany adres
intersection	Intersection	Adres wyniku.
locality	string	Właściwość lokalna
neighborhood	string	Nieruchomość w sąsiedztwie
postalCode	string	Właściwość Kod pocztowy
streetName	string	Nazwa ulicy z formattedAddress
streetNumber	string	Numer na ulicy, jeśli jest dostępny, from formattedAddress

AddressAdminDistrictsItem

Objekt

Nazwa poddziału w kraju lub regionie dla adresu.

Nazwa	Typ	Opis
name	string	Nazwa odpowiedniego pola adminDistrict, For adminDistrict[0], może to być pełna nazwa stanu, takiego jak Washington, For adminDistrict[1], może to być pełna nazwa powiatu
shortName	string	Krótka nazwa odpowiedniego pola adminDistrict, For adminDistrict[0], może to być krótka nazwa stanu, takiego jak WA, For adminDistrict[1], może to być krótka nazwa hrabstwa

AddressCountryRegion

Objekt

Kraj lub region wraz z jego nazwą i kodem ISO.

Nazwa	Typ	Opis
ISO	string	ISO kraju/regionu
name	string	nazwa kraju/regionu

AutocompleteFeature

Objekt

Funkcje autouzupełniania wyników

Nazwa	Typ	Opis
geometry	GeoJsonPoint	Prawidłowy typ geometrii `GeoJSON Point`. Aby uzyskać szczegółowe informacje, zobacz RFC 7946.
properties	AutocompleteProperties	Właściwości wyniku autouzupełniania
type	FeatureTypeEnum	Określa typ `GeoJSON`. Jedynym obsługiwanym typem obiektu jest Funkcja. Aby uzyskać więcej informacji, zobacz RFC 7946.

AutocompleteProperties

Objekt

Właściwości wyniku autouzupełniania

Nazwa	Typ	Opis
address	Address	Adres wyniku
name	string	Nazwa miejsca. To pole nie zostanie wyświetlone, jeśli zwracanym typem jest Adres.
type	AutocompleteResultTypeEnum	Rodzaj sugestii
typeGroup	AutocompleteResultTypeGroupsEnum	Adres lub miejsce

AutocompleteResponse

Objekt

Ten obiekt jest zwracany po pomyślnym wywołaniu autouzupełniania.

Nazwa	Typ	Opis
features	AutocompleteFeature[]	Cechy wyniku autouzupełniania
nextLink	string	Jest to link do następnej strony zwróconych funkcji. Jeśli jest to ostatnia strona, nie ma tego pola.
type	FeatureCollectionEnum	Określa typ `GeoJSON`. Jedynym obsługiwanym typem obiektu jest `FeatureCollection`. Aby uzyskać więcej informacji, zobacz RFC 7946.

AutocompleteResultTypeEnum

Wyliczenie

Rodzaj sugestii

Wartość	Opis
Address	Address
AdminDivision1	AdminDivision1
AdminDivision2	AdminDivision2
AdminDivision3	AdminDivision3
AdministrativeBuilding	Budynek administracyjny
Airport	Lotnisko
AirportTerminal	AirportTerminal
AmusementPark	Park Rozrywki
AncientSite	AncientSite
Aquarium	Akwarium
Archipelago	Archipelag
Basin	Basen
Battlefield	Pole bitwy
Bay	Bay
Beach	Plaża
Bridge	Mostek
BusinessStructure	Struktura biznesowa
Camp	Obóz
Canal	Kanał
Casino	Kasyno
Castle	Zamek
Cave	Jaskinia
Cemetery	Cmentarz
Channel	Kanał
Church	Kościół
Cliff	Klif
Coast	Wybrzeże
CommunityCenter	CommunityCenter
Continent	Continent
CountryRegion	CountryRegion
Crater	Krater
CulturalRegion	Region Kulturowy
Dam	Tama
Delta	Delta
Desert	Pustynia
DrainageBasin	Zbiornik zlewni
Dune	Diuna
FacilityStructure	Struktura obiektu
FerryTerminal	Terminal promowy
FinancialStructure	Struktura finansowa
FireStation	FireStation
Forest	Las
Fort	Fort
Garden	Ogród
Geyser	Gejzer
Glacier	Lodowiec
GolfCourse	GolfCourse
GreaterPopulatedPlace	WiększeMiastoLudność
HigherEducationFacility	HigherEducationFacility
HistoricalSite	Historyczne miejsce
Hospital	Szpital
HotSpring	Gorące Źródło
Ice	Lód
IndigenousPeoplesReserve	Rezerwat Ludów Rdzennych
IndustrialStructure	Struktura Przemysłowa
Island	Wyspa
Isthmus	Przesmyk
Lake	Jezioro
LandArea	LandArea
Landform	Forma terenu
LandmarkBuilding	LandmarkBudynek
Library	Biblioteka
Lighthouse	Latarnia morska
Marina	Marina
Market	Rynek
MedicalStructure	MedicalStructure
MetroStation	MetroStation
MilitaryBase	MilitaryBase
Mission	Misja
Monument	Pomnik
Mosque	Meczet
Mountain	Góra
MountainRange	MountainRange
MultiModalStation	MultiModalStation
Museum	Muzeum
NauticalStructure	Struktura NauticalStructure
Neighborhood	Sąsiedztwo
Oasis	Oaza
ObservationPoint	Punkt Obserwacyjny
Ocean	Ocean
OfficeBuilding	Budynek biurowy
Other	Other
Park	Park
ParkingStructure	ParkingStructure
Pass	Przepustka
Peninsula	Półwysep
Plain	Równina
Planet	Planeta
Plateau	Plateau
Playground	Playground
PlayingField	PlayingField
Pole	Pole
PoliticalUnit	PoliticalUnit
PopulatedPlace	Zapełnione miejsce
Port	Port
Postcode1	Kod pocztowy1
Promontory	Przylądek
RaceTrack	RaceTrack
RailwayStation	Stacja kolejowa
Reef	Rafa
ReligiousStructure	Struktura religijna
Reserve	Rezerwat
ResidentialStructure	Struktura mieszkaniowa
River	Rzeka
RoadBlock	Blokada
Ruin	Ruina
ScientificResearchBase	ScientificResearchBase
Sea	Morze
SeaplaneLandingArea	Obszar lądowania wodnosamolotów
Shrine	Sanktuarium
SkiArea	SkiArea
Spring	Wiosna
Stadium	Stadion
StatisticalDistrict	StatisticalDistrict
Temple	Świątynia
Theater	Teatr
TouristRailway	Kolej turystyczna
TouristStructure	TouristStructure
Trailhead	Wejście na szlak
TransportationStructure	Struktura transportu
Tunnel	Tunel
Valley	Dolina
Volcano	Wulkan
Walkway	Chodnik
Wall	Tablica
Waterfall	Kaskadowy
WaterFeature	WaterFeature
Wetland	Tereny podmokłe
Winery	Winnica
Zoo	Zoo

AutocompleteResultTypeGroupsEnum

Wyliczenie

Adres lub miejsce

Wartość	Opis
Address	Określona lokalizacja adresu. Obsługiwane typy to: Address Blokada
Place	Wszystkie inne typy należą do grupy Typ miejsca. Mogą to być jednostki, takie jak AdminDivision1, Neighborhood, PopulatedPlace i inne.

Wartość

Opis

Address

Określona lokalizacja adresu. Obsługiwane typy to:

Address
Blokada

Place

Wszystkie inne typy należą do grupy Typ miejsca. Mogą to być jednostki, takie jak AdminDivision1, Neighborhood, PopulatedPlace i inne.

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

FeatureCollectionEnum

Wyliczenie

Określa typ GeoJSON. Jedynym obsługiwanym typem obiektu jest FeatureCollection. Aby uzyskać więcej informacji, zobacz RFC 7946.

Wartość	Opis
FeatureCollection	Określa typ obiektu `GeoJSONFeatureCollection`.

FeatureTypeEnum

Wyliczenie

Typ funkcji musi mieć wartość Funkcja.

Wartość	Opis
Feature	Określa typ obiektu funkcji `GeoJSON`.

GeoJsonObjectType

Wyliczenie

Określa typ GeoJSON. Musi być jednym z dziewięciu prawidłowych typów obiektów GeoJSON — Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature i FeatureCollection.

Wartość	Opis
Point	`GeoJSON Point` geometrii.
MultiPoint	`GeoJSON MultiPoint` geometrii.
LineString	`GeoJSON LineString` geometrii.
MultiLineString	`GeoJSON MultiLineString` geometrii.
Polygon	`GeoJSON Polygon` geometrii.
MultiPolygon	`GeoJSON MultiPolygon` geometrii.
GeometryCollection	`GeoJSON GeometryCollection` geometrii.
Feature	`GeoJSON Feature` obiekt.
FeatureCollection	`GeoJSON FeatureCollection` obiekt.

GeoJsonPoint

Objekt

Prawidłowy typ geometrii GeoJSON Point. Aby uzyskać szczegółowe informacje, zobacz RFC 7946.

Nazwa	Typ	Opis
bbox	number[] (double)	Obwiedni. Używane projekcje — EPSG:3857. Aby uzyskać szczegółowe informacje, zobacz RFC 7946.
coordinates	number[] (double)	`Position` to tablica liczb z co najmniej dwoma elementami. Dwa pierwsze elementy to długości geograficznej i szerokości geograficznej, dokładnie w tej kolejności. wysokości/wysokości jest opcjonalnym trzecim elementem. Aby uzyskać szczegółowe informacje, zobacz RFC 7946.
type	string: Point	Określa typ `GeoJSON`. Musi być jednym z dziewięciu prawidłowych typów obiektów GeoJSON — Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature i FeatureCollection.

Intersection

Objekt

Adres wyniku.

Nazwa	Typ	Opis
baseStreet	string	Główna ulica dla lokalizacji.
displayName	string	Pełna nazwa skrzyżowania.
intersectionType	string	Typ skrzyżowania.
secondaryStreet1	string	Pierwsza przecinając ulicę.
secondaryStreet2	string	Jeśli istnieje, druga przecinając ulicę.

Udostępnij za pośrednictwem

Search - Get Geocode Autocomplete

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

AadToken

Zakresy

subscription-key

SAS Token

Przykłady

Autocomplete API call to search for '1 Microsoft'

Przykładowe żądanie

Przykładowa odpowiedź

Autocomplete API call to search for '1 Microsoft Way, Redmond', filtered by roadblock resultTypes, place resultTypeGroups, and return empty result

Przykładowe żądanie

Przykładowa odpowiedź

Autocomplete API call to search for 'Muir Woods', filtered by address resultTypeGroups

Przykładowe żądanie

Przykładowa odpowiedź

Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups

Przykładowe żądanie

Przykładowa odpowiedź

Autocomplete API call to search for 'Muir Woods', filtered by park resultTypes

Przykładowe żądanie

Przykładowa odpowiedź

Autocomplete API call to search for 'Muir Woods', filtered by place resultTypeGroups

Przykładowe żądanie

Przykładowa odpowiedź

Autocomplete API call to search for 'Muir Woods', filtered by roadblock resultTypes, address resultTypeGroups

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Address

AddressAdminDistrictsItem

AddressCountryRegion

AutocompleteFeature

AutocompleteProperties

AutocompleteResponse

AutocompleteResultTypeEnum

AutocompleteResultTypeGroupsEnum

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

FeatureCollectionEnum

FeatureTypeEnum

GeoJsonObjectType

GeoJsonPoint

Intersection