모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Places API Web Service 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Places API Web Service 활성화
  3. 적합한 키 생성
계속

장소 세부정보

장소 검색에서 place_idreference가 있는 경우 장소 세부정보 요청을 실행하여 특정 시설이나 관심 지점에 대한 추가 세부정보를 요청할 수 있습니다. 장소 세부정보 요청은 전체 주소, 전화번호, 사용자 평점 및 리뷰와 같이 지정된 장소에 대한 더 포괄적인 정보를 반환합니다.

장소 세부정보 요청

장소 세부정보 요청은 다음 형식의 HTTP URL입니다.

https://maps.googleapis.com/maps/api/place/details/output?parameters

여기서 output은 다음 값 중 하나입니다.

  • json(권장)은 출력을 JSON(JavaScript Object Notation) 형식으로 나타냅니다.
  • xml은 출력을 XML로 나타냅니다.

검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. URL 표준 형식과 마찬가지로, 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다. 매개변수 및 가능한 값 목록은 아래에 나와 있습니다.

  • key(필수) — 애플리케이션의 API 키입니다. 이 키는 할당량 관리 목적으로 애플리케이션을 식별하고 이 애플리케이션에서 추가한 장소를 앱에서 즉시 사용할 수 있도록 합니다. 자세한 내용은 키 가져오기를 참조하세요.
  • placeid 또는 reference 중 하나를 반드시 지정해야 하지만 둘 다 필요하지는 않습니다.
    • placeidID — 장소를 고유하게 식별하는 텍스트 식별자이며, 장소 검색에서 반환됩니다. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참조하세요.
    • reference — 장소를 고유하게 식별하는 텍스트 식별자이며, 장소 검색에서 반환됩니다. 참고: reference는 이제 지원이 중단되고 place_id로 대체됩니다. 이 페이지의 사용 중단 알림을 참조하세요.
선택적 매개변수
  • extensions(선택 항목) — 장소 세부정보 응답에 추가 필드를 포함해야 하는지를 나타냅니다. 추가 필드에는 추가 라이선스가 필요한 프리미엄 데이터 또는 일반적으로 요청되지 않는 값 등이 포함될 수 있습니다. 확장 매개변수는 현재 시험용 버전입니다. 확장 매개변수로 지원되는 값은 다음과 같습니다.
    • review_summary에는 Google 편집 팀에서 선별한 풍부하고 간결한 리뷰가 포함됩니다.
  • language(선택 항목) — 결과를 반환하는 데 사용되는 언어를 나타내는 언어 코드입니다(가능한 경우). 일부 필드는 요청한 언어로 제공되지 않을 수도 있습니다. 지원되는 언어 목록 및 관련 코드를 참조하세요. 지원되는 언어는 자주 업데이트되므로 목록이 완전하지 않을 수 있습니다.

다음 예시는 placeid를 사용하여 장소 세부정보를 요청합니다.

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4&key=YOUR_API_KEY

애플리케이션에서 요청이 제대로 작동되려면 이 예시의 키를 본인의 API 키로 대체해야 합니다.

다음 예시는 지원이 중단된 reference 매개변수를 사용합니다.

https://maps.googleapis.com/maps/api/place/details/json?reference=CmRYAAAAciqGsTRX1mXRvuXSH2ErwW-jCINE1aLiwP64MCWDN5vkXvXoQGPKldMfmdGyqWSpm7BEYCgDm-iv7Kc2PF7QA7brMAwBbAcqMr5i1f4PwTpaovIZjysCEZTry8Ez30wpEhCNCXpynextCld2EBsDkRKsGhSLayuRyFsex6JA6NPh9dyupoTH3g&key=YOUR_API_KEY

장소 세부정보 응답

장소 세부정보 응답은 URL 요청의 경로 내에 output 플래그에서 지정한 형식으로 반환됩니다.


JSON
{
   "html_attributions" : [],
   "result" : {
      "address_components" : [
         {
            "long_name" : "48",
            "short_name" : "48",
            "types" : [ "street_number" ]
         },
         {
            "long_name" : "Pirrama Road",
            "short_name" : "Pirrama Road",
            "types" : [ "route" ]
         },
         {
            "long_name" : "Pyrmont",
            "short_name" : "Pyrmont",
            "types" : [ "locality", "political" ]
         },
         {
            "long_name" : "NSW",
            "short_name" : "NSW",
            "types" : [ "administrative_area_level_1", "political" ]
         },
         {
            "long_name" : "AU",
            "short_name" : "AU",
            "types" : [ "country", "political" ]
         },
         {
            "long_name" : "2009",
            "short_name" : "2009",
            "types" : [ "postal_code" ]
         }
      ],
      "formatted_address" : "48 Pirrama Road, Pyrmont NSW, Australia",
      "formatted_phone_number" : "(02) 9374 4000",
      "geometry" : {
         "location" : {
           "lat" : -33.8669710,
           "lng" : 151.1958750
         },
         "viewport" : {
            "northeast" : {
               "lat" : -33.8665053,
               "lng" : 151.1960371
            },
            "southwest" : {
               "lat" : -33.8669293,
               "lng" : 151.1952183
            }
         }
      },
      "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
      "id" : "4f89212bf76dde31f092cfc14d7506555d85b5c7",
      "international_phone_number" : "+61 2 9374 4000",
      "name" : "Google Sydney",
      "place_id" : "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "scope" : "GOOGLE",
      "alt_ids" : [
         {
            "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
            "scope" : "APP"
         }
      ],
      "rating" : 4.70,
      "reference" : "CnRsAAAA98C4wD-VFvzGq-KHVEFhlHuy1TD1W6UYZw7KjuvfVsKMRZkbCVBVDxXFOOCM108n9PuJMJxeAxix3WB6B16c1p2bY1ZQyOrcu1d9247xQhUmPgYjN37JMo5QBsWipTsnoIZA9yAzA-0pnxFM6yAcDhIQbU0z05f3xD3m9NQnhEDjvBoUw-BdcocVpXzKFcnMXUpf-nkyF1w",
      "reviews" : [
         {
            "aspects" : [
               {
                  "rating" : 3,
                  "type" : "quality"
               }
            ],
            "author_name" : "Simon Bengtsson",
            "author_url" : "https://plus.google.com/104675092887960962573",
            "language" : "en",
            "rating" : 5,
            "text" : "Just went inside to have a look at Google. Amazing.",
            "time" : 1338440552869
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Felix Rauch Valenti",
            "author_url" : "https://plus.google.com/103291556674373289857",
            "language" : "en",
            "rating" : 5,
            "text" : "Best place to work :-)",
            "time" : 1338411244325
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Chris",
            "language" : "en",
            "rating" : 5,
            "text" : "Great place to work, always lots of free food!",
            "time" : 1330467089039
         }
      ],
      "types" : [ "establishment" ],
      "url" : "http://maps.google.com/maps/place?cid=10281119596374313554",
      "vicinity" : "48 Pirrama Road, Pyrmont",
      "website" : "http://www.google.com.au/"
   },
   "status" : "OK"
}
      
XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Sydney</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Road, Pyrmont NSW, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Road</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>NSW</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>AU</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
     <lat>-33.8669710</lat>
     <lng>151.1958750</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8669293</lat>
     <lng>151.1952183</lng>
    </southwest>
    <northeast>
     <lat>-33.8665053</lat>
     <lng>151.1960371</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.7</rating>
  <url>http://maps.google.com/maps/place?cid=10281119596374313554</url>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png</icon>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CnRsAAAAoGXc0eAcQOoO1A7sU58repRnghwM5q7UtsZFhVtjYtfKN_LFAPhdhBfUAU8m0EzeSyP0cDBi7kazZwNjlIMUqktqIanMiymuRDS8c539M6KCJNUMkjw22WXxtl3QoR25fIf-7YJnpza6bMIuFZ1CKBIQuBsbXu8xkbUNofECCkdvmxoU5k3Lpbr8XNCbofIKtsZxj8GloGA</reference>
  <id>4f89212bf76dde31f092cfc14d7506555d85b5c7</id>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://www.google.com.au/</website>
  <review>
   <time>1338440552869</time>
   <text>Just went inside to have a look at Google. Amazing.</text>
   <author_name>Simon Bengtsson</author_name>
   <author_url>https://plus.google.com/104675092887960962573</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1338411244325</time>
   <text>Best place to work :-)</text>
   <author_name>Felix Rauch Valenti</author_name>
   <author_url>https://plus.google.com/103291556674373289857</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1330467089039</time>
   <text>Great place to work, always lots of free food!</text>
   <author_name>Chris</author_name>
   <author_url>https://maps.google.com/maps/user?uid=211457841236072500285</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
 </result>
</PlaceDetailsResponse>

JSON 응답은 다음의 세 가지 루트 요소를 포함합니다.

  • "status"는 요청의 메타데이터를 포함합니다. 아래의 상태 코드를 참조하세요.
  • "result"는 요청한 장소에 대한 세부정보를 포함합니다. 이러한 결과에 대한 자세한 내용은 장소 세부정보 결과를 참조하세요.
  • "html_attributions"는 사용자에게 표시되어야 하는 이 목록에 대한 특성 집합을 포함합니다.

JSON 응답 구문 분석에 대한 도움말은 Javascript로 JSON 처리를 참조하세요.

XML 응답은 다음과 같은 단일 <PlaceDetailsResponse> 요소와 세 개의 최상위 요소로 구성됩니다.

  • <status>는 요청의 메타데이터를 포함합니다. 상태 코드를 참조하세요.
  • 단일 <result> 요소는 단일 시설에 대한 세부정보를 포함합니다. 결과에 대한 자세한 내용은 장소 세부정보 결과를 참조하세요.
  • <html_attributions>는 사용자에게 표시되어야 하는 특성 집합을 포함합니다.

출력 처리에 권장되는 디자인 패턴을 확인하려면 XPath로 XML 구문 분석을 참조하세요.

상태 코드

장소 응답 객체의 "status" 필드는 요청의 상태를 포함합니다. 또한 장소 요청이 실패한 원인을 추적하는 데 도움이 되는 디버깅 정보를 포함할 수 있습니다. "status" 필드는 다음 값을 포함할 수 있습니다.

  • OK는 오류가 발생되지 않았음을 나타냅니다. 장소가 성공적으로 감지되었고 최소 한 개 이상의 결과가 반환되었습니다.
  • UNKNOWN_ERROR는 서버 측 오류를 나타냅니다. 다시 시도하면 성공할 수도 있습니다.
  • ZERO_RESULTS는 참조가 올바르지만, 더 이상 올바른 결과를 참조하지 않음을 나타냅니다. 사업체가 더 이상 운영되지 않는 경우에 발생할 수 있습니다.
  • OVER_QUERY_LIMIT는 할당량이 초과되었음을 나타냅니다.
  • REQUEST_DENIED는 요청이 거부되었음을 나타냅니다. 일반적인 원인은 key 매개변수가 잘못되었기 때문입니다.
  • INVALID_REQUEST는 일반적으로 쿼리(reference)가 누락되었음을 나타냅니다.
  • NOT_FOUND는 참조된 위치를 장소 데이터베이스에서 찾지 못했음을 나타냅니다.

오류 메시지

Google Places 서비스가 OK 이외의 상태 코드를 반환하면 세부정보 응답 객체에 추가 error_message 필드가 있을 수 있습니다. 이 필드에는 지정된 상태 코드가 제시된 이유에 대한 상세정보가 포함됩니다.

장소 세부정보 결과

장소 서비스가 세부정보 요청에서 결과를 반환하는 경우, 결과는 단일 result 내에 배치됩니다. 각 결과는 다음 필드를 포함할 수 있습니다.

  • address_components[]는 지정된 주소를 구성하는 데 사용되는 개별 주소 구성 요소의 배열입니다. 예를 들어, '111 8th Avenue, New York, NY'라는 주소는 '111'(번지), '8th Avenue'(도로), 'New York'(시) 및 'NY'(미국의 주)와 같은 개별 주소 구성 요소를 포함합니다. 각 address_component는 일반적으로 다음 항목을 포함합니다.
    • types[]는 주소 구성 요소의 유형을 나타내는 배열입니다.
    • long_name은 전체 텍스트 설명 또는 주소 구성 요소의 이름입니다.
    • short_name은 주소 구성 요소의 텍스트 약칭입니다(해당되는 경우). 예를 들어, 알래스카 주의 주소 구성 요소는 'Alaska'의 long_name과 두 글자의 우편 약자를 사용하는 'AK'의 short_name을 가질 수 있습니다.
  • formatted_address는 이 장소의 사람이 읽을 수 있는 주소가 포함된 문자열입니다. 이 주소는 대개 "우편 주소"와 일치하지만 국가마다 다를 수 있습니다. 이 주소는 일반적으로 하나 이상의 address_component로 구성됩니다.
  • formatted_phone_number에는 장소의 전화번호가 현지 형식으로 포함됩니다. 예를 들어, Google 호주 시드니 지사의 formatted_phone_number(02) 9374 4000입니다.
  • geometry에는 다음 정보가 포함됩니다.
    • location은 이 장소에 대해 지오코딩된 위도,경도 값을 포함합니다.
    • viewport는 이 장소를 지도상에 LatLngBounds로 표시할 때 선호되는 뷰포트를 포함합니다.
  • icon은 결과가 지도에 나타날 때 사용자 앱에 표시되는 권장 아이콘의 URL을 포함합니다.
  • id는 이 장소를 표시하는 안정적인 고유 식별자를 포함합니다. 이 식별자는 이 장소에 대한 정보를 검색하는 데 사용할 수 없지만, 장소에 관한 데이터를 통합하고 별도의 검색을 통해 장소의 ID를 확인하는 데 사용할 수 있습니다. ID는 가끔 변경될 수 있습니다. 따라서 저장된 장소의 ID는 같은 장소의 차후 세부정보 요청에서 반환된 ID와 비교하여 필요한 경우 업데이트할 것을 권장합니다. 참고: id는 이제 지원이 중단되고 place_id로 대체됩니다. 이 페이지의 사용 중단 알림을 참조하세요.
  • international_phone_number에는 장소의 전화번호가 국제 형식으로 포함됩니다. 국제 형식에는 국가 코드가 포함되며 플러스(+) 부호가 접두사로 붙습니다. 예를 들어, Google 호주 시드니 지사의 international_phone_number+61 2 9374 4000입니다.
  • name은 사람이 읽을 수 있는 반환된 결과의 이름을 포함합니다. establishment 결과에서, 이 이름은 대개 정식 사업체 이름입니다.
  • opening_hours에는 다음 정보가 포함됩니다.
    • open-now는 장소가 현재 영업 중임을 나타내는 부울 값입니다.
    • periods[]는 7일 단위의 영업 기간 배열로, 일요일부터 시작하여 순서대로 지정됩니다. 각 기간에는 다음과 같은 항목이 포함됩니다.
      • open은 장소의 영업 시작 시간을 나타내는 요일 및 시간 객체의 쌍을 포함합니다.
        • day는 일요일부터 시작하여 각 요일에 해당하는 0~6까지의 숫자를 포함합니다. 예를 들어, 2는 화요일을 의미합니다.
        • time은 24시간 hhmm 형식의 시간을 포함할 수 있습니다. 값의 범위는 0000~2359입니다. time은 해당 장소의 시간대로 표시됩니다.
      • close는 장소의 영업 종료 시간을 나타내는 요일 및 시간 객체의 쌍을 포함합니다. 참고: 장소가 24시간 열려 있으면, close 섹션은 응답에서 누락됩니다. 고객은 open 기간의 day 값이 0이고 time 값이 0000이고 close 값이 없으면, 항시 열려 있다고 신뢰할 수 있습니다.
    • weekday_text는 각 요일의 지정된 개점 시간을 나타내는 7개의 문자열 배열입니다. 장소 세부정보 요청에 language 매개변수가 지정된 경우, 장소 서비스는 해당 언어에 맞게 개점 시간을 적절히 구성하고 현지화합니다. 이 배열에서 요소의 순서는 language 매개변수에 따라 다릅니다. 일부 언어는 월요일에 한 주를 시작하고 다른 언어는 일요일에 시작합니다.
  • permanently_closed는 장소가 영구적으로 폐점되었는지 여부를 나타내는 부울 플래그입니다(true 값). 장소가 영구적으로 폐점되지 않은 경우 이 플래그는 응답에서 제외됩니다.
  • photos[]photo 객체의 배열이며 각 배열에는 이미지 참조가 포함됩니다. 장소 세부정보 요청은 최대 10개의 사진을 반환할 수 있습니다. 장소 사진에 대한 자세한 내용과 이미지를 애플리케이션에서 사용하는 방법은 장소 사진 문서에서 찾을 수 있습니다. 다음은 photo 객체에 대한 설명입니다.
    • photo_reference — 사진 요청을 수행하는 경우 사진을 식별하는 데 사용되는 문자열입니다.
    • height — 이미지의 최대 높이.
    • width — 이미지의 최대 너비.
    • html_attributions[] — 모든 필수 특성을 포함합니다. 이 필드는 항상 존재하지만 비어있는 경우도 있습니다.
  • place_id: 장소를 고유하게 식별하는 텍스트 식별자. 장소에 관한 정보를 검색하려면, 이 식별자를 Places API 요청의 placeId 필드에 삽입해 전달합니다. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참조하세요.
  • scope: place_id의 범위를 나타냅니다. 사용할 수 있는 값은 다음과 같습니다.
    • APP: 장소 ID는 본인의 애플리케이션에서만 인식됩니다. 그 이유는 장소를 애플리케이션에 추가했지만 아직 중재 절차를 통과하지 않았기 때문입니다.
    • GOOGLE: 장소 ID를 다른 애플리케이션과 Google 지도에서 사용할 수 있습니다.
  • alt_ids — 장소에 대한 0개 이상 대체 장소 ID의 배열이며, 각 대체 장소 ID에 관련된 범위를 포함합니다. 참고: 이 배열은 비어 있거나 없을 수 있습니다. 있을 경우, 다음 필드를 포함합니다.
    • place_id — 한 장소가 대체 장소 ID를 갖게 되는 가장 큰 이유는 애플리케이션에 장소를 추가하면 애플리케이션 범위의 장소 ID를 부여받고, 이후 중재 절차를 통과하면 Google 범위의 장소 ID를 부여받기 때문입니다.
    • scope — 대체 장소 ID의 범위는 항시 APP이며, 이는 대체 장소 ID가 애플리케이션에서만 인식된다는 것을 의미합니다.
    예를 들어, 애플리케이션이 한 장소를 추가하고 새로운 장소에 대해 AAA라는 place_id를 부여받았다고 가정합니다. 이후, 장소가 중재 절차를 통과해 Google 범위의 BBB라는 place_id를 부여받았다고 가정합니다. 이 시점부터 이 장소에 대한 정보에는 다음이 포함됩니다.
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level — 장소의 가격 수준(0~4등급). 특정 값이 나타내는 정확한 금액은 지역별로 다릅니다. 가격 수준은 다음과 같이 해석될 수 있습니다.
    • 0 — 무료
    • 1 — 저렴
    • 2 — 보통
    • 3 — 비쌈
    • 4 — 매우 비쌈
  • rating은 장소의 평점을 포함합니다(집계된 사용자 리뷰 기준으로 1.0~5.0).
  • reference는 향후 세부정보 서비스를 검색하는 데 사용할 수 있는 토큰을 포함합니다. 이 토큰은 세부정보 서비스에 대한 요청에 사용된 참조와 다를 수 있습니다. 장소에 대해 저장된 참조는 정기적으로 업데이트하는 것이 좋습니다. 토큰은 장소를 고유하게 식별하지만 장소는 토큰을 식별하지 못합니다. 한 장소에 다수의 유효한 참조 토큰이 있을 수 있습니다. 참고: reference는 이제 지원이 중단되고 place_id로 대체됩니다. 이 페이지의 사용 중단 고지를 참조하세요.
  • reviews[]는 최대 5개의 리뷰로 구성된 JSON 배열입니다. 장소 세부정보 요청에 language 매개변수가 지정된 경우, 장소 서비스는 해당 언어로 작성된 리뷰를 선호하도록 결과를 편중합니다. 각 리뷰는 여러 구성 요소로 구성됩니다.
    • aspectsAspectRating 객체 컬렉션을 포함하며, 각 객체는 해당 시설의 단일 속성에 대한 평점을 제공합니다. 컬렉션의 첫 번째 객체가 기본 평가항목으로 간주됩니다. 다음은 각 AspectRating에 대한 설명입니다.
      • type은 평점을 받는 평가항목의 이름입니다. 다음 유형이 지원됩니다: appeal, atmosphere, decor, facilities, food, overall, qualityservice.
      • rating은 특정 평가항목에 대한 사용자 평점입니다(0~3).
    • author_name은 리뷰를 제출한 사용자의 이름입니다. 익명 리뷰는 "Google 사용자"로 표시됩니다.
    • author_url은 사용자 Google+ 프로필의 URL입니다(있는 경우).
    • language는 사용자 리뷰에 사용된 언어를 표시하는 IETF 언어 코드입니다. 이 필드에는 기본 언어 태그만 포함되며, 국가나 지역을 표시하는 보조 태그는 포함되지 않습니다. 예를 들어, 모든 영어 리뷰는 'en'으로만 태그가 지정되며 'en-AU'나 'en-UK'와 같은 태그는 없습니다.
    • rating은 이 장소에 대한 사용자의 전체적 평점입니다. 평점은 1~5 사이의 정수입니다.
    • text는 사용자 리뷰입니다. Google Places에서 위치를 리뷰할 때, 텍스트 리뷰는 선택 항목입니다. 따라서 필드가 비어 있는 경우도 있습니다. 이 필드에는 간단한 HTML 마크업이 포함될 수 있습니다. 예를 들어, 항목 참조 &amp;는 앰퍼샌드 문자를 나타낼 수 있습니다.
    • time은 리뷰가 제출된 시간이며 1970년 1월 1일 자정(UTC) 이후의 시간을 초 단위로 측정합니다.
  • types[]는 특정 결과를 설명하는 지형지물 유형의 배열을 포함합니다. 자세한 내용은 지원 유형 목록을 참조하세요. 둘 이상의 유형이 결과에 할당되어 있을 경우, XML 응답에는 여러 <type> 요소가 포함됩니다.
  • URL은 이 장소에 대한 공식 Google 페이지의 URL을 포함합니다. 이 URL은 해당 장소에 대한 최선의 정보가 포함된 Google 소유 페이지가 됩니다. 애플리케이션에서는 이 장소에 대한 자세한 결과를 사용자에게 표시하는 모든 화면에 이 페이지를 링크하거나 포함해야 합니다.
  • utc_offset은 장소의 현재 시간대가 UTC와 얼마나 차이가 나는지 분 단위로 보여주는 정보를 포함합니다. 예를 들어, 서머타임 기간 동안 호주 시드니에 위치한 장소의 값은 660(UTC에서 +11시간)이며, 서머타임을 벗어난 캘리포니아에 있는 장소의 값은 -480(UTC에서 -8시간)이 됩니다.
  • vicinity는 거리 이름, 번지, 지역을 비롯하여 장소의 단순화된 주소를 나열하지만 시/도, 우편 번호 또는 국가를 나열하지는 않습니다. 예를 들어, Google 호주 시드니 사무실의 vicinity 값은 48 Pirrama Road, Pyrmont입니다.
  • website는 사업체의 홈페이지 등 장소의 공식적인 웹사이트를 나열합니다.

일부 위치에서 다차원 평점을 사용하지 못할 수도 있습니다. 리뷰 수가 거의 없는 경우 세부정보 응답에 기존 1.0~5.0의 평점이 포함되거나(있을 경우) 아예 포함되지 않습니다.

프리미엄 데이터

위에 나오는 필드 이외에도, 프리미엄 플랜 라이선스를 가진 Google Places API 고객은 다음 필드를 받을 수 있습니다. 이러한 필드는 result 필드의 최상위 하위 항목으로 표시됩니다.

  • aspectsAspectRating 객체 컬렉션을 포함하며, 각 객체는 해당 시설의 단일 특성에 대한 종합 평점을 제공합니다. 컬렉션의 첫 번째 객체가 기본 평가항목으로 간주됩니다. 다음은 각 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."

sensor 매개변수

이전의 Google Places API Web Service는 사용자 위치 파악을 위해 애플리케이션의 센서 사용 여부를 표시하는 sensor 매개변수를 포함하도록 요구했습니다. 이 매개변수는 더 이상 필요하지 않습니다.

다음에 대한 의견 보내기...

location_on
Google Places API Web Service