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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

  • Autouzupełnianie (nowe) używa żądań HTTP POST. Przekazuj parametry w treści żądania lub w nagłówkach w ramach żądania HTTP POST. W przeciwieństwie do starszych interfejsów API parametry adresu URL przekazujesz za pomocą żądania HTTP GET.
  • Autouzupełnianie (nowe) obsługuje zarówno klucze API , jak i tokeny OAuth jako mechanizm uwierzytelniania.
  • W przypadku autouzupełniania (nowego) jako format odpowiedzi obsługiwany jest tylko format JSON.

W tabeli poniżej znajdziesz listę parametrów w interfejsach Place Autocomplete (Legacy) i Query Autocomplete (Legacy), które zostały zmienione lub zmodyfikowane w przypadku autouzupełniania (nowego), oraz parametrów, które nie są już obsługiwane.

Obecny 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 preferencji 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 Place Autocomplete (Legacy). W tym przykładzie prosisz o odpowiedź w formacie JSON zawierającą 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 (nowego), ale można ich używać do filtrowania określonych wyników w odpowiedzi. Na przykład to żą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).