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

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

В этом выпуске ответ от текстового поиска, поиска поблизости и сведений о месте также может содержать ссылки на Карты Google. Ваши пользователи могут перейти по этим ссылкам на Карты Google, чтобы увидеть дополнительную информацию о месте в ответе.

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

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

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

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

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

Попробуйте!

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

Ссылка на Google Карты Описание Имя поля
Место Ссылка для открытия Google Maps на это место. googleMapsLinks.placeUri
Направления Ссылка для открытия маршрута к месту на Google Maps. googleMapsLinks.directionsUri
Написать отзыв Ссылка для написания отзыва о месте на Картах Google. googleMapsLinks.writeAReviewUri
Читать отзывы Ссылка для просмотра отзывов об этом месте на Картах Google. googleMapsLinks.reviewsUri
Фотографии Ссылка для просмотра фотографий места на Картах Google. googleMapsLinks.photosUri

Цены

Эта функция находится на стадии предварительной версии GA, и за ее использование во время предварительной версии плата не взимается. Это означает, что оплата за использование во время предварительной версии составляет 0 долларов США. Подробную информацию о предлагаемых ценах см. в разделе «Использование и выставление счетов Places API» .

Ссылки в ответе места содержатся в поле 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

В этом выпуске поле googleMapsUri добавляется к объектам Reviews и Photos в ответе. При переходе по этим ссылкам открывается обзор или фотография на Картах 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 и опциями API.

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

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

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

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

  5. На панели API Explorer выберите значок развертывания, Разверните API Explorer. , чтобы развернуть окно API Explorer.