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

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

Ответы на запросы от новых функций текстового поиска, поиска поблизости и информации о местах также могут содержать ссылки на 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 в маску поля запроса.

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

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 Картах.

Например, в следующем запросе текстового поиска (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. Нажмите кнопку Execute (Выполнить). В диалоговом окне выберите аккаунт, который хотите использовать для отправки запроса.

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

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