Переход на автозаполнение (новое)

Places API поддерживает Place Autocomplete (Legacy) и Query Autocomplete (Legacy) API. Если вы знакомы с этими API, Autocomplete (New) вносит следующие изменения:

  • Autocomplete (New) использует запросы HTTP POST. Передавайте параметры в теле запроса или в заголовках как часть запроса HTTP POST. В отличие от устаревших API, вы передаете параметры URL с помощью запроса HTTP GET.
  • Автозаполнение (новое) поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.
  • В качестве формата ответа в функции автозаполнения (новое) поддерживается только JSON.

В следующей таблице перечислены параметры Place Autocomplete (устаревшая версия) и Query Autocomplete (устаревшая версия), которые были переименованы или изменены для Autocomplete (новая версия), а также параметры, которые больше не поддерживаются.

Текущий параметр Новый параметр Примечания
components includedRegionCodes
language languageCode
location locationBias
ipbias Если вы пропустите и locationBias , и locationRestriction , то API будет использовать смещение IP по умолчанию.
offset inputOffset
radius locationBias или locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Пример запроса

Следующий пример запроса GET использует Place Autocomplete (Legacy). В этом примере вы запрашиваете ответ JSON, содержащий информацию о местах под названием «Amoeba», которые относятся к типу establishment и передают все параметры как параметры 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'

С помощью функции автозаполнения (новая) вы создаете запрос POST и передаете все параметры в теле запроса JSON или в заголовках как часть запроса POST.

Маски полей не требуются для запросов Autocomplete (New), но их можно использовать для фильтрации определенных результатов в ответе. Например, следующий запрос использует маску поля, поэтому ответ включает только suggestions.placePrediction.text предложения:

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

Дополнительную информацию об использовании масок полей см. в разделе Сведения о месте (новое) .