Przełącz na autouzupełnianie (nowość)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Interfejs Places API obsługuje interfejsy Autouzupełnianie miejsc (starszy) i Query Autocomplete (starszy). Jeśli znasz te interfejsy API, w przypadku interfejsu Autocomplete (New) wprowadziliśmy te zmiany:

  • Autouzupełnianie (nowe) używa żądań HTTP POST. Przekazuj parametry w treści żądania lub w nagłówkach w ramach żądania HTTP POST. W przeciwieństwie do starszych interfejsów API parametry URL przekazujesz za pomocą żądania GET.
  • Autouzupełnianie (nowe) obsługuje zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
  • W przypadku funkcji Autocomplete (New) jako format odpowiedzi obsługiwany jest tylko JSON.

W tabeli poniżej znajdziesz listę parametrów w usługach Autouzupełnianie miejsc (starsza wersja) i Autocomplete zapytania (starsza wersja), które zostały zmienione lub zmodyfikowane w usłudze Autocomplete (nowa wersja), oraz parametrów, które nie są już obsługiwane.

Bieżący parametr Nowy parametr Uwagi
components includedRegionCodes
language languageCode
location locationBias
ipbias Jeśli pominiesz oba parametry locationBias i locationRestriction, interfejs API domyślnie będzie używać określania prawdopodobieństwa na podstawie adresu IP.
offset inputOffset
radius locationBias lub locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Przykładowe żądanie

Ten przykładowy kod wysyła żądanie GET do interfejsu Autouzupełnianie miejsc (starsza wersja). W tym przykładzie wysyłasz żądanie odpowiedzi JSON zawierającej informacje o miejscach o nazwie „Amoeba” typu establishment i przekazujesz wszystkie parametry jako parametry adresu URL:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

W przypadku Autocomplete (nowa) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach żądania POST.

Maski pól nie są wymagane w przypadku żądań autouzupełniania (nowego), ale można ich używać do filtrowania konkretnych wyników w odpowiedzi. Na przykład poniższe żądanie używa maski pola, więc odpowiedź zawiera tylko suggestions.placePrediction.text sugestii:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

Więcej informacji o używaniu masek pól znajdziesz w sekcji Informacje o miejscu (nowe).