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

Разработчики Европейской экономической зоны (ЕЭЗ)

Введение

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

  • Функция автозаполнения (новая) использует 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-запроса используется функция автозаполнения мест (устаревшая). В этом примере вы запрашиваете JSON-ответ, содержащий информацию о местах под названием «Амоба» типа 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.

Маски полей не требуются для запросов автозаполнения (новых), но их можно использовать для фильтрации определённых результатов в ответе. Например, в следующем запросе используется маска поля, поэтому ответ включает только 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

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