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

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

Введение

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

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

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

Текущий параметр Новый параметр Примечания
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-ответ, содержащий информацию о местах под названием "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-запроса.

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

Чтобы узнать больше об использовании масок полей, см. раздел «Подробная информация о местах (новое)» .