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

Interfejs Places API obsługuje interfejsy Autouzupełnianie (starsza wersja) i Autouzupełnianie zapytań (starsza wersja). Jeśli znasz te interfejsy API, Autocomplete (Nowy) wprowadza następujące zmiany:

  • Autouzupełnianie (nowa wersja) korzysta z żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach jako część żądania HTTP POST. W przypadku starszych interfejsów API parametry adresu URL przekazujesz za pomocą żądania HTTP GET.
  • Autouzupełnianie (nowa wersja) obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i OAuth.
  • W przypadku funkcji Autocomplete (Nowa) obsługiwany jest tylko format odpowiedzi JSON.

W tabeli poniżej znajdziesz parametry starszych interfejsów Autocomplete API i Autocomplete Query API, które zostały zmienione lub zmodyfikowane w ramach Autocomplete (New), oraz parametry, które nie są już obsługiwane.

Parametr prądu Nowy parametr Uwagi
components includedRegionCodes
language languageCode
location locationBias
ipbias Jeśli pominiesz zarówno parametr locationBias, jak i locationRestriction, interfejs API będzie domyślnie używać ukierunkowania na adres IP.
offset inputOffset
radius locationBias lub locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Przykładowe żądanie

Ten przykładowy żądanie GET używa autouzupełniania miejsc (starsza wersja). W tym przykładzie żądasz odpowiedzi JSON zawierającej informacje o miejscach o nazwie „Amoeba”, które są 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 funkcji Autocomplete (Nowa) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach jako część żądania POST.

Maski pól nie są wymagane w przypadku żądań autouzupełniania (nowej wersji), ale można ich użyć do filtrowania określonych wyników w odpowiedzi. Na przykład to żą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 artykule Szczegóły miejsc (nowa wersja).