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