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, Autouzupełnianie (nowe) wprowadza te zmiany:

  • Autouzupełnianie (nowe) używa żądań POST HTTP. 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 jako mechanizm uwierzytelniania zarówno klucze interfejsu API, jak i tokeny OAuth.
  • W przypadku Autouzupełniania (nowego) obsługiwany jest tylko format JSON.

W tabeli poniżej znajdziesz parametry funkcji Autouzupełnianie miejsc (starsza wersja) i Autouzupełnianie zapytania (starsza wersja), które zostały zmienione lub zmodyfikowane w przypadku Autouzupełniania (nowa wersja), oraz parametry, które nie są już obsługiwane.

Bieżący parametr Nowy parametr Uwagi
components includedRegionCodes
language languageCode
location locationBias
ipbias Jeśli pominiesz zarówno locationBias, jak i locationRestriction, interfejs API domyślnie użyje kierowania 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 żą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 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 (nowych), 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).