API Places (новый) принимает запросы на данные о местах различными способами. Ответ API Places (новый) содержит данные о месте, включая данные о местоположении и изображения, географические координаты и известные достопримечательности.
В ответах на текстовый поиск (новая функция), поиск поблизости (новая функция) и подробную информацию о месте (новая функция) также могут содержаться ссылки на Google Maps. Ваши пользователи могут перейти по этим ссылкам на Google Maps, чтобы увидеть дополнительную информацию о месте, указанном в ответе.
Например, вы ищете аэропорты в Сан-Франциско, штат Калифорния. В ответе в список мест входит Международный аэропорт Сан-Франциско (SFO). Объект Place для SFO в ответе добавляет поле googleMapsUri , содержащее ссылки Google Maps для открытия карты Google Maps до этого места, указания маршрута, отзывов о месте и фотографий места.
Наряду со ссылками, добавленными в объект Place , поле googleMapsUri также добавляется в объекты Reviews и Photos в ответе:
Reviews.googleMapsUri: Содержит ссылку на отзыв в Google Maps, чтобы вы могли просмотреть его в браузере.Photos.googleMapsUri: Содержит ссылку на фотографию в Google Maps, чтобы вы могли просмотреть её в браузере.
API Explorer позволяет отправлять запросы в режиме реального времени, чтобы вы могли ознакомиться с новыми возможностями:
Поддерживаемые ссылки Google Maps для данного места
В следующей таблице приведены ссылки на Google Maps, которые вы можете включить в ответ:
| ссылка на Google Maps | Описание | Название поля |
|---|---|---|
| Место | Ссылка для открытия этого места на Google Maps. | googleMapsLinks.placeUri |
| Направления | Ссылка для открытия маршрута до этого места в Google Maps. | googleMapsLinks.directionsUri |
| Написать отзыв | Ссылка для написания отзыва о месте в Google Maps. | googleMapsLinks.writeAReviewUri |
| Читать отзывы | Ссылка для просмотра отзывов об этом месте на Google Maps. | googleMapsLinks.reviewsUri |
| Фотографии | Ссылка для просмотра фотографий этого места на Google Maps. | googleMapsLinks.photosUri |
Включите все ссылки в ответ на вопрос о местах.
Ссылки в ответе, содержащем информацию о местах, находятся в поле googleMapsLinks . Убедитесь, что вы включили поле googleMapsLinks в маску поля запроса, если хотите, чтобы они отображались в ответе.
Например, следующий текстовый поиск (новый) включает все ссылки на карты в ответ:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'
Ответ представлен в следующем виде:
{
"places": [
{
"formattedAddress": "San Francisco, CA 94128, USA",
"displayName": {
"text": "San Francisco International Airport",
"languageCode": "en"
},
"googleMapsLinks": {
"placeUri": "https://maps.google.com/?cid=11885663895765773631",
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
}
}
]
}Включите в ответ конкретную ссылку.
Вам не обязательно возвращать все ссылки в ответе. Например, если вам нужна только ссылка на фотографии в ответе, измените маску поля, как показано ниже, чтобы включить только поле photosUri :
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'
Включите указания в ответ.
Все методы класса Places поддерживают генерацию ссылки на маршрут в ответе. В качестве начальной точки используется текущее местоположение, в качестве конечной точки — местоположение места, а режим передвижения — автомобиль.
В следующем примере используется функция «Поиск поблизости (новый)», чтобы включить ссылку на карту с маршрутом в ответ в поле directionsUri :
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": -33.8688,
"longitude": 151.1957362},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby
Включите ссылки на отзывы и фотографии.
В этом обновлении в объекты Reviews и Photos в ответе добавлено поле googleMapsUri . Переход по этим ссылкам открывает отзыв или фотографию в Google Maps.
Например, следующий текстовый поиск (новый) включает отзывы и фотографии для каждого места в ответе:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'
В ответе каждый элемент массива reviews and photos содержит поле googleMapsUri для открытия отзыва или фотографии в браузере.
Попробуйте!
API Explorer позволяет создавать тестовые запросы, чтобы вы могли ознакомиться с API и его параметрами.
Выберите значок в правой части страницы.
При желании разверните раздел «Показать стандартные параметры» и установите параметр
fieldsв значение маски поля .При желании можно отредактировать текст запроса .
Нажмите кнопку «Выполнить» . В диалоговом окне выберите учетную запись, которую вы хотите использовать для выполнения запроса.
В панели API Explorer выберите
Для развертывания окна API Explorer разверните его на весь экран .