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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

  • Autouzupełnianie (nowe) używa żądań 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) obsługiwany jest tylko format 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), 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 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 usługi autouzupełniania miejsc (starszej wersji). 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 (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).