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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Interfejs Places API obsługuje interfejsy Autouzupełnianie miejsc (starsza wersja) i Autouzupełnianie zapytań (starsza wersja). Jeśli znasz te interfejsy API, Autouzupełnianie (nowa wersja) wprowadza te zmiany:

  • Autouzupełnianie (nowe) używa żądań POST HTTP. Przekaż parametry w treści żądania lub w nagłówkach w ramach żądania POST. W przypadku starszych interfejsów API parametry adresu URL przekazuje się 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 Autouzupełniania miejsc (starsza wersja) i Autouzupełniania zapytania (starsza wersja), które zostały zmienione lub zmodyfikowane w Autouzupełnianiu (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 parametr 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

W tym przykładzie żądania GET użyto 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 Autouzupełniania (nowego) 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 artykule Informacje o miejscu (nowość).