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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Interfejs Places API obsługuje interfejsy Place Autocomplete (starszy)Query Autocomplete (starszy). Jeśli znasz te interfejsy API, Autocomplete (New) wprowadza te zmiany:

  • Autouzupełnianie (nowe) korzysta z żądania HTTP POST. Przekazywanie parametrów 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 HTTP GET.
  • Autouzupełnianie (nowe) obsługuje zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
  • W przypadku funkcji Autocomplete (New) jako formatu odpowiedzi obsługiwany jest tylko JSON.

W tabeli poniżej znajdziesz parametry w usługach Autouzupełnianie miejsca (starsza wersja) i Autouzupełnianie zapytania (starsza wersja), które zostały zmienione lub zmodyfikowane w usłudze Autouzupełnianie (nowa wersja), a także 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 będzie używać 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 Autocomplete API miejsc (starsza wersja). W tym przykładzie wysyłasz żądanie odpowiedzi w formacie 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 (New) 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, dzięki czemu 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 miejsca (nowe).