Ссылка на Google Карты

API Places (новый) принимает запросы на данные о местах различными способами. Ответ API Places (новый) содержит данные о месте, включая данные о местоположении и изображения, географические координаты и важные достопримечательности.

Ответы от функций «Текстовый поиск» (новый), «Поиск поблизости» (новый) и «Информация о месте» (новый) также могут содержать ссылки на Google Карты. Ваши пользователи могут перейти по этим ссылкам в Google Картах, чтобы увидеть дополнительную информацию о месте в ответе.

Например, вы ищете аэропорты в Сан-Франциско, Калифорния. В ответе Международный аэропорт Сан-Франциско (SFO) включается в список мест. Объект Place для SFO в ответе добавляет поле googleMapsUri , содержащее ссылки Google Maps для открытия этого места, схемы проезда, отзывы о месте и фотографии.

Наряду со ссылками, добавленными в объект Place , поле googleMapsUri также добавляется в объекты Reviews и Photos в ответе:

• Reviews.googleMapsUri : содержит ссылку на обзор в Картах Google, чтобы вы могли просмотреть его в браузере.

• Photos.googleMapsUri : содержит ссылку на фотографию в Картах Google, чтобы вы могли просмотреть ее в браузере.

API Explorer позволяет вам делать живые запросы, чтобы вы могли ознакомиться со следующими новыми возможностями:

Попробуйте!

Поддерживаемые ссылки Google Maps для места

В следующей таблице показаны ссылки Google Maps, которые вы можете включить в ответ:

Включить все ссылки в ответ «Места»

Ссылки в ответе о местах содержатся в поле 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 поддерживают генерацию ссылки с маршрутом в ответе. Текущее местоположение используется в качестве исходной точки, местоположение места — в качестве конечной точки, а режим передвижения — «Автомобиль».

В следующем примере используется Nearby Search (New) для включения ссылки на маршрут карты в ответ в поле 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 Картах.

Например, следующий текстовый поиск (новый) включает обзоры и фотографии для каждого места в ответе:

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'

В ответе каждый элемент массива отзывов и фотографий содержит поле googleMapsUri для открытия отзыва или фотографии в браузере.

Попробуйте!

API Explorer позволяет вам делать образцы запросов, чтобы вы могли ознакомиться с API и его параметрами.

1. Выберите значок api на правой стороне страницы.

2. При необходимости разверните Показать стандартные параметры и задайте параметру fields маску поля .

3. При желании отредактируйте тело запроса .

4. Нажмите кнопку «Выполнить» . В диалоговом окне выберите учётную запись, которую вы хотите использовать для отправки запроса.

5. На панели обозревателя API выберите fullscreen

   Развернуть на весь экран , чтобы развернуть окно API Explorer.