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

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

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

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

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

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

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

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

Попробовать

Поддерживаемые ссылки на места в Google Картах

В таблице ниже приведены ссылки на Google Карты, которые можно включить в ответ.

Включить все ссылки в ответ Places API

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

В следующем примере с помощью поиска поблизости (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 Картах.

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

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 и photos содержит поле googleMapsUri, чтобы открыть отзыв или фотографию в браузере.

Попробовать

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

1. Нажмите на значок api API справа на странице.

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

3. При необходимости измените тело запроса.

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

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

   Полноэкранный режим, чтобы развернуть окно API Explorer.