프리미엄 데이터

이전 Google Maps APIs for Work 또는 Google Maps API for Business 라이선스를 보유한 고객은 Google Places API for Work의 일부분으로 Google Places API를 구매합니다. 이 문서 섹션은 API의 프리미엄 데이터 활성화에 대해 설명합니다.

개요

Google Places API Web Service는 전 세계 수천 개의 식당, 바 및 기타 위치에 대한 평가와 리뷰에 대한 액세스 권한을 제공합니다. 프리미엄 데이터 기능을 사용하면 Google Places API Web Service의 일부로 향상된 리뷰 데이터에 프로그래밍 방식으로 액세스할 수 있습니다. 프리미엄 데이터가 활성화되면 30포인트 점수, 상세한 수치 평가, 리뷰 요약(해당되는 경우) 등의 추가 콘텐츠를 받습니다.

프리미엄 데이터 기능은 기존 Google Places API Web Service를 기반으로 합니다. 자세한 내용은 개발자 문서를 참조하세요.

활성화

시작하기 전에 Google Places API Web Service에서 프리미엄 데이터 액세스 권한이 있는 계정에 액세스해야 합니다. 계정이 활성화되면 키가 포함된 쿼리가 향상된 리뷰 및 평가에 액세스할 수 있습니다. 응답의 상세도 수준은 장소 검색 요청 및 장소 세부정보 요청에 따라 달라집니다.

다음 절차에 따라 Google API Console에서 계정이 활성화되었는지 확인할 수 있습니다.

  1. Google API Console을 방문하여 Google 계정으로 로그인합니다.
  2. 로그인 시 생성된 프로젝트를 선택합니다. 프로젝트 이름은 Google Maps APIs for Business 또는 Google Maps for Work 또는 Google Maps로 시작합니다.
  3. Enabled APIs 목록에서 Places API - Zagat Content 서비스가 활성화되어 있어야 합니다. Google Places API Web Service 서비스는 비활성화되어 있어야 합니다.

프리미엄 데이터에 액세스하고 싶지만 프로젝트에서 프리미엄 데이터가 활성화되어 있지 않다면 계정 관리자에게 문의하세요.

프리미엄 데이터 기능

참고: 현재 프리미엄 데이터는 Google Places API Web Service 에서만 제공됩니다. Google Maps JavaScript API 장소 라이브러리에서는 사용할 수 없습니다.

장소 검색

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 레이블은 지속적으로 평이 좋은 장소 또는 특별하거나 고유한 특징을 가진 장소를 나타냅니다.

장소 세부정보 응답

다음 예시에서는 aspectsreview_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."