Премиум-данные

Для пользователей с лицензией на ранее выпускавшийся продукт Google Maps APIs for Work или лицензией Google Maps API for Business право использовать Google Places API приобретается в составе Google Places API for Work. В этом разделе документации описывается активация премиум-данных для этого API.

Обзор

Google Places API Web Service предоставляет доступ к рейтингам и обзорам тысяч ресторанов, баров и других мест во всем мире. С функцией премиум-данных вы можете программировать доступ к расширенным данным обзоров в составе Google Places API Web Service. Включение функции премиум-данных позволяет вам получить доступ к дополнительному контенту, такому как оценка по 30-балльной шкале, подробные числовые рейтинги и, при наличии, сводному обзору.

Функция премиум-данных основана на существующем Google Places API Web Service. Дополнительную информацию см. в документации для разработчиков.

Активация

Прежде чем начать, вам потребуется доступ к учетной записи с доступом к премиум-данным из Google Places API Web Service. После активации вашей учетной записи запросы с вашим ключом будут иметь доступ к расширенным отзывам и рейтингам. Уровень детализации ответа варьируется между запросами Place Search и запросами Place Details.

Вы можете проверить активацию вашей учетной записи в Google API Console, используя следующие шаги.

  1. Перейдите в Google API Console и войдите в свою учетную запись Google.
  2. Выберите проект, который был создан для вас при регистрации. Название проекта начинается с Google Maps APIs for Business or Google Maps for Work or Google Maps.
  3. В списке Enabled APIs должна быть включена служба Places API - Zagat Content. Служба Google Places API Web Service должна быть отключена.

Если вы хотите получить доступ к премиум-данным, но ваш проект не активирован для них, свяжитесь с менеджером по работе с клиентами.

Возможности премиум-данных

Примечание. Премиум-данные в настоящее время доступны только в Google Places API Web Service. Они недоступны в библиотеке Google Maps JavaScript API Places.

Поиск мест

В дополнение к стандартным полям ответа пользователи Google Places API for Work могут получать следующие поля. Они будут возвращаться в виде дочерних полей верхнего уровня по отношению к полю result.

  • aspects (устаревшая возможность) – содержит один объект AspectRating с основной оценкой заведения. Каждый объект AspectRating описывается следующим образом:
    • type: название оцениваемого критерия. Например: атмосфера, обслуживание, кухня, общее впечатление и т. д.
    • rating: сводная оценка по определенному критерию, от 0 до 30. Обратите внимание на то, что сводная оценка может составлять от 0 до 30 баллов, тогда как оценки в отзывах выставляются в диапазоне от 0 до 3 баллов.
  • zagat_selected (устаревшая возможность) указывает, что место включено в каталог службы Zagat. Этим знаком Zagat отмечает только те места, которые известны своим неизменно высоким качеством обслуживания, уникальной атмосферой или специализацией.

Запросы данных о месте

В дополнение к стандартным полям ответа пользователи Google Places API for Work могут получать следующие поля. Они будут возвращаться в виде дочерних полей верхнего уровня по отношению к полю result.

  • aspects (устаревшая возможность) – содержит один объект AspectRating с основной оценкой заведения. Каждый объект AspectRating описывается следующим образом:
    • type: название оцениваемого критерия. Например: атмосфера, обслуживание, кухня, общее впечатление и т. д.
    • rating: сводная оценка по определенному критерию, от 0 до 30. Обратите внимание на то, что сводная оценка составляет от 0 до 30 баллов, тогда как оценки в отзывах выставляются в диапазоне от 0 до 3 баллов.
  • review_summary (устаревшая возможность) содержит описательный краткий обзор, проверенный сотрудниками редакции Google. Это поле возвращается в результатах поиска, только если включить в запрос данных параметр extensions=review_summary.
  • zagat_selected (устаревшая возможность) указывает, что это место включено в каталог службы Zagat. Этим знаком Zagat отмечает только те места, которые известны своим неизменно высоким качеством обслуживания, уникальной атмосферой или специализацией.

Ответы на запросы данных о месте

В следующем примере показано отображение полей aspects и review_summary в теле ответа:

"aspects" : [
   {
      "rating" : 24,
      "type" : "food"
   },
   {
      "rating" : 21,
      "type" : "decor"
   },
   {
      "rating" : 24,
      "type" : "service"
   }
],

...

"review_summary" : "For a meal that's a \"leisurely celebration\",
Mountain View \"foodies\" head to this \"lovely\" old Victorian house, where
\"artful\", \"high-end\" New French tasting dinners that \"look great and taste
even better\" are enhanced by sommelier-selected wines and service that
\"anticipates your every need\"; a garden out back supplies some ingredients,
while four dining areas provide \"lovely decor and ambiance\"; P.S. an
abbreviated tasting menu is also available."