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

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

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

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

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

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" \
https://places.googleapis.com/v1/places:autocomplete