Place Details (기존)

유럽 경제 지역 (EEA) 개발자

장소 검색에서 place_id를 얻은 후 장소 세부정보 (기존) 요청을 시작하여 특정 시설 또는 관심 장소에 대한 자세한 내용을 요청할 수 있습니다. 장소 세부정보 (레거시) 요청은 전체 주소, 전화번호, 사용자 평점 및 리뷰 등 표시된 장소에 대한 포괄적인 정보를 반환합니다.

장소 세부정보 (기존) 요청

장소 세부정보 (레거시) 요청은 다음 형식의 HTTP URL입니다.

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

여기서 output은 다음 값 중 하나일 수 있습니다.

  • json (권장)은 JavaScript 객체 표기법 (JSON)으로 출력을 나타냅니다.
  • xml는 XML로 출력을 나타냅니다.

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

필수 매개변수

  • place_id

    장소 검색에서 반환되며 장소를 고유하게 식별하는 텍스트 식별자입니다. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참고하세요.

선택적 매개변수

  • 필드

    주의: 장소 검색 요청과 장소 세부정보 요청은 동일한 필드를 반환하지 않습니다. 장소 검색 요청은 장소 세부정보 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 검색에서 원하는 필드를 반환하지 않는 경우 장소 검색을 사용하여 place_id를 가져온 다음 이 장소 ID를 사용하여 장소 세부정보를 요청할 수 있습니다. 장소 검색 요청에서 사용할 수 없는 필드에 대한 자세한 내용은 Places API 필드 지원을 참고하세요.

    fields 매개변수를 사용하여 반환할 장소 데이터 유형의 쉼표로 구분된 목록을 지정합니다. 예를 들면 fields=formatted_address,name,geometry입니다. 복합 값을 지정할 때는 슬래시를 사용하세요. 예를 들면 opening_hours/open_now입니다.

    필드는 기본, 연락처, 분위기 등 세 가지 결제 카테고리로 분류됩니다. Basic, Contact, Atmosphere SKU는 이를 트리거한 요청의 기본 SKU (Place Details, Find Place, Nearby Search, Text Search) 외에 추가로 요금이 청구됩니다. 자세한 내용은 가격 시트를 참고하세요.

    기본

    기본 카테고리에는 다음 필드가 포함됩니다. address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (지원 중단됨), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    연락처

    연락처 카테고리에는 다음 필드가 포함됩니다. current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    분위기

    분위기 카테고리에는 다음 필드가 포함됩니다. curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

    참고: 저작자 표시(html_attributions)는 필드 요청 여부에 관계없이 모든 호출에서 항상 반환됩니다.

  • language

    결과를 반환할 언어입니다.

    • 지원되는 언어 목록을 참고하세요. Google에서는 지원되는 언어를 자주 업데이트하므로 이 목록에 모든 언어가 포함되지 않을 수도 있습니다.
    • language가 제공되지 않으면 API는 Accept-Language 헤더에 지정된 기본 언어를 사용하려고 시도합니다.
    • API는 사용자와 현지인 모두가 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이 목표를 달성하기 위해 선호하는 언어를 준수하여 필요한 경우 사용자가 읽을 수 있는 스크립트로 음역된 현지 언어의 거리 주소를 반환합니다. 다른 모든 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 첫 번째 구성요소에서 선택한 동일한 언어로 반환됩니다.
    • 선호하는 언어로 이름을 사용할 수 없는 경우 API는 가장 일치하는 이름을 사용합니다.
    • 기본 언어는 API가 반환하도록 선택한 결과 집합과 반환되는 순서에 약간의 영향을 미칩니다. 지오코더는 언어에 따라 약어를 다르게 해석합니다. 예를 들어 거리 유형의 약어나 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않은 동의어가 있습니다. 예를 들어 utca와 tér은 헝가리어로 거리의 동의어입니다.

  • 지역

    ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 주목할 만한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb' (기술적으로 '영국' 법인의 경우)입니다.

  • reviews_no_translations

    리뷰 번역을 사용 중지하려면 reviews_no_translations=true를 지정하고, 리뷰 번역을 사용 설정하려면 reviews_no_translations=false를 지정합니다. 리뷰는 원래 언어로 반환됩니다.

    생략되거나 값이 없이 전달되면 리뷰 번역이 사용 설정됩니다. 요청에 language 매개변수가 지정된 경우 지정된 언어를 번역의 기본 언어로 사용합니다. language이 생략되면 API는 Accept-Language 헤더를 기본 언어로 사용하려고 시도합니다.

  • reviews_sort

    리뷰를 반환할 때 사용할 정렬 방법입니다. most_relevant (기본값) 또는 newest로 설정할 수 있습니다.

    • most_relevant (기본값)의 경우 리뷰가 관련성을 기준으로 정렬됩니다. 서비스는 기본 언어로 원래 작성된 리뷰를 반환하도록 결과를 편향시킵니다.
    • newest의 경우 리뷰가 시간순으로 정렬되며 선호하는 언어는 정렬 순서에 영향을 주지 않습니다.

    리뷰가 정렬되는 방식을 최종 사용자에게 표시하는 것이 좋습니다.

  • sessiontoken

    결제 목적으로 자동 완성 세션을 식별하는 임의의 문자열입니다.

    세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 Place Details 호출이 이루어지면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소가 선택됩니다. 세션 내 각 요청에 사용되는 API 키는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱에서 각 세션에 대해 새 토큰을 생성해야 합니다. sessiontoken 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다(각 요청에 대해 별도로 요금이 청구됨).

    다음 가이드라인이 권장됩니다.

    • 모든 자동 완성 세션에 세션 토큰을 사용합니다.
    • 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다.
    • 세션 내의 모든 Place Autocomplete 및 Place Details 요청에 사용되는 API 키가 동일한 Cloud 콘솔 프로젝트에 속하는지 확인합니다.
    • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

Place Details (Legacy) 예

다음 예에서는 place_id로 장소의 세부정보를 요청하고 name, rating, formatted_phone_number 필드를 포함합니다.

Shell

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

애플리케이션에서 요청이 작동하려면 이 예의 키를 자체 API 키로 바꿔야 합니다.

장소 세부정보 (기존) 응답

장소 세부정보 (레거시) 응답은 요청의 URL 경로 내에 있는 output 플래그로 표시된 형식으로 반환됩니다.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, 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 Rd</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>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</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.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

JSON 및 XML 응답에는 각각 다음 요소가 포함됩니다.

PlacesDetailsResponse

필드 필수 유형 설명
required Array<string>

사용자에게 표시해야 하는 이 비즈니스 정보에 관한 속성 집합을 포함할 수 있습니다 (일부 비즈니스 정보에는 속성이 없을 수 있음).

required 장소

요청된 장소에 관한 세부정보가 포함됩니다.

자세한 내용은 장소를 참고하세요.
required PlacesDetailsStatus

요청의 상태를 포함하며 요청이 실패한 이유를 추적하는 데 도움이 되는 디버깅 정보가 포함될 수도 있습니다.

자세한 내용은 PlacesDetailsStatus를 참고하세요.

선택사항 Array<string>

서비스에서 요청 사양에 관한 추가 정보를 반환하는 경우 응답 객체 내에 info_messages 필드가 추가로 있을 수 있습니다. 이 필드는 성공한 요청에만 반환됩니다. 항상 반환되지 않을 수 있으며 콘텐츠는 변경될 수 있습니다.

JSON 응답에서 이러한 요소는 루트 요소로 표시됩니다. XML 응답에서 이러한 요소는 <PlaceDetailsResponse> 아래의 최상위 요소로 표시됩니다.

PlacesDetailsStatus

서비스에서 반환된 상태 코드입니다.

  • OK - API 요청이 성공적이었음을 나타냅니다.
  • ZERO_RESULTS: 참조된 위치 place_id가 유효했지만 더 이상 유효한 결과를 참조하지 않음을 나타냅니다. 사업체가 더 이상 운영되지 않는 경우에 발생할 수 있습니다.
  • NOT_FOUND: 참조된 위치 place_id을 장소 데이터베이스에서 찾을 수 없음을 나타냅니다.
  • INVALID_REQUEST - API 요청의 형식이 잘못되었음을 나타냅니다.
  • OVER_QUERY_LIMIT: 다음 중 하나를 나타냅니다.
    • QPS 한도를 초과했습니다.
    • 계정에 결제가 사용 설정되어 있지 않습니다.
    • 월 $200 크레딧 또는 자체 설정 사용량 한도를 초과했습니다.
    • 제공된 결제 수단이 더 이상 유효하지 않습니다 (예: 신용카드가 만료됨).
    이 오류를 해결하는 방법에 대한 자세한 내용은 지도 FAQ를 참고하세요.
  • REQUEST_DENIED - 요청이 거부되었음을 나타냅니다. 일반적으로 다음과 같은 이유 때문입니다.
    • 요청에 API 키가 누락되었습니다.
    • key 매개변수가 잘못되었습니다.
  • UNKNOWN_ERROR - 알 수 없는 오류를 나타냅니다.

장소

장소를 설명하는 속성입니다. 일부 장소 유형에서는 일부 속성을 사용할 수 없습니다.

필드 필수 유형 설명
선택사항 Array<AddressComponent>

이 주소에 적용할 수 있는 별도의 구성요소가 포함된 배열입니다.

자세한 내용은 AddressComponent를 참고하세요.

선택사항 문자열

adr 마이크로포맷의 장소 주소를 나타냅니다.

선택사항 문자열

장소가 비즈니스인 경우 장소의 영업 상태를 나타냅니다. 데이터가 없으면 business_status가 반환되지 않습니다.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
선택사항 부울

비즈니스에서 차량 수령을 지원하는지 여부를 지정합니다.
선택사항 PlaceOpeningHours

다음 7일간 (오늘 포함)의 영업시간을 포함합니다. 기간은 요청일의 자정에 시작하여 6일 후 오후 11시 59분에 종료됩니다. 이 필드에는 예외적인 시간이 있는 날짜에 설정된 모든 시간의 special_days 하위 필드가 포함됩니다.

자세한 내용은 PlaceOpeningHours를 참고하세요.

선택사항 부울

비즈니스에서 배송을 지원하는지 여부를 지정합니다.
선택사항 부울

비즈니스에서 실내 또는 실외 좌석 옵션을 지원하는지 여부를 지정합니다.

선택사항 PlaceEditorialSummary

장소의 요약이 포함됩니다. 요약은 텍스트 개요로 구성되며, 해당하는 경우 이러한 언어의 언어 코드도 포함됩니다. 요약 텍스트는 있는 그대로 표시해야 하며 수정하거나 변경할 수 없습니다.

자세한 내용은 PlaceEditorialSummary를 참고하세요.

선택사항 문자열

이 장소의 사람이 읽을 수 있는 주소가 포함된 문자열입니다.

이 주소는 대개 우편 주소와 일치합니다. 참고: 영국과 같은 일부 국가에서는 라이선스 제한으로 인해 실제 우편 주소의 배포가 허용되지 않습니다.

형식이 지정된 주소는 하나 이상의 주소 구성요소로 논리적으로 구성됩니다. 예를 들어 주소 '111 8th Avenue, New York, NY'는 '111' (번지), '8th Avenue' (경로), 'New York' (도시) 및 'NY' (미국의 주)로 구성됩니다.

형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요. 대신 API 응답에 형식이 지정된 주소 필드 외에 포함되는 개별 주소 구성요소를 사용해야 합니다.

선택사항 문자열

장소의 전화번호가 현지 형식으로 포함됩니다.

선택사항 Geometry

위치의 위치와 표시 영역을 포함합니다.

자세한 내용은 Geometry를 참고하세요.
선택사항 문자열

지도에 이 결과를 표시할 때 사용자에게 표시될 수 있는 추천 아이콘의 URL을 포함합니다.

선택사항 문자열

장소 카테고리의 기본 16진수 색상 코드를 포함합니다.
선택사항 문자열

권장 아이콘의 URL에서 .svg 또는 .png 파일 형식 확장자를 뺀 값을 포함합니다.

선택사항 문자열

장소의 전화번호가 국가 코드 포함 형식으로 포함됩니다. 국가 코드 포함 형식에는 국가 코드가 포함되며 앞에 더하기(+) 기호가 붙습니다. 예를 들어 Google 오스트레일리아 시드니 사무실의 international_phone_number는 +61 2 9374 4000입니다.

선택사항 문자열

반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. establishment 결과의 경우 일반적으로 표준화된 업체 이름입니다.

선택사항 PlaceOpeningHours

정규 영업시간을 포함합니다.

자세한 내용은 PlaceOpeningHours를 참고하세요.

선택사항 부울

business_status을 사용하여 비즈니스의 영업 상태를 가져옵니다.

선택사항 Array<PlacePhoto>

사진 객체의 배열이며, 각 객체에는 이미지에 대한 참조가 포함됩니다. 요청은 최대 10장의 사진을 반환할 수 있습니다. 장소 사진 및 애플리케이션에서 이미지를 사용하는 방법에 관한 자세한 내용은 장소 사진 문서를 참고하세요.

자세한 내용은 PlacePhoto를 참고하세요.
선택사항 문자열

장소를 고유하게 식별하는 텍스트 식별자. 장소에 관한 정보를 가져오려면 Places API 요청의 place_id 필드에 이 식별자를 전달하세요. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참고하세요.

선택사항 PlusCode

위도와 경도 좌표에서 파생된 인코딩된 위치 참조로 1/8000도x1/8000도 (적도에서 14mx14m) 이하의 영역을 나타냅니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다. Open Location Code 및 플러스 코드를 참고하세요.

자세한 내용은 PlusCode를 참고하세요.
선택사항 숫자

장소의 가격 수준입니다(0~4). 특정 값으로 표시된 정확한 금액은 지역마다 다릅니다. 가격 수준은 다음과 같이 해석됩니다.

  • 0 무료
  • 1 저렴함
  • 2 보통
  • 3 비쌈
  • 4 매우 비쌈
선택사항 숫자

집계된 사용자 리뷰를 기준으로 한 장소 평점(1.0~5.0)이 포함됩니다.

선택사항 문자열
선택사항 부울

장소에서 예약을 지원하는지 여부를 지정합니다.
선택사항 Array<PlaceReview>

최대 5개의 리뷰로 구성된 JSON 배열입니다. 기본적으로 리뷰는 관련성 순으로 정렬됩니다. reviews_sort 요청 매개변수를 사용하여 정렬을 제어합니다.

  • most_relevant (기본값)의 경우 리뷰가 관련성을 기준으로 정렬됩니다. 서비스는 기본 언어로 원래 작성된 리뷰를 반환하도록 결과를 편향시킵니다.
  • newest의 경우 리뷰가 시간순으로 정렬됩니다. 선호하는 언어는 정렬 순서에 영향을 주지 않습니다.

Google에서는 결과가 most_relevant 또는 newest에 따라 정렬되는지 사용자에게 표시할 것을 권장합니다.

자세한 내용은 PlaceReview를 참고하세요.

선택사항 문자열
선택사항 Array<PlaceOpeningHours>

비즈니스의 보조 영업시간에 관한 정보를 비롯해 다음 7일 동안의 항목 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 영업시간이나 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 미리 정의된 영업시간 유형 목록 (예: DRIVE_THROUGH, PICKUP 또는 TAKEOUT)에서 가져온 type 하위 필드를 채웁니다. 이 필드에는 예외적인 시간이 있는 날짜에 설정된 모든 시간의 special_days 하위 필드가 포함됩니다.

자세한 내용은 PlaceOpeningHours를 참고하세요.

선택사항 부울

장소에서 맥주를 판매하는지 여부를 지정합니다.
선택사항 부울

장소에서 아침 식사를 제공하는지 여부를 지정합니다.
선택사항 부울

장소에서 브런치를 제공하는지 여부를 지정합니다.
선택사항 부울

장소에서 저녁 식사를 제공하는지 여부를 지정합니다.
선택사항 부울

장소에서 점심을 제공하는지 여부를 지정합니다.
선택사항 부울

장소에서 채식 요리를 제공하는지 여부를 지정합니다.
선택사항 부울

장소에서 와인을 판매하는지 여부를 지정합니다.
선택사항 부울

비즈니스에서 테이크아웃을 지원하는지 여부를 지정합니다.
선택사항 Array<string>

주어진 결과를 설명하는 기능 유형의 배열을 포함합니다. 지원되는 유형의 목록을 참고하세요.

선택사항 문자열

이 장소의 공식 Google 페이지 URL이 포함됩니다. 장소에 대한 최상의 정보가 포함된 Google 소유 페이지입니다. 애플리케이션에서는 장소에 대한 자세한 결과를 사용자에게 표시하는 모든 화면에 이 페이지를 연결하거나 포함해야 합니다.

선택사항 숫자

이 장소에 대한 총 리뷰 수(텍스트 유무와 관계없음)입니다.

선택사항 숫자

이 장소의 현재 시간대가 UTC에서 오프셋된 분 수를 포함합니다. 예를 들어 오스트레일리아 시드니의 경우 일광 절약 시간 동안 660 (UTC에서 +11시간)이고, 캘리포니아의 경우 일광 절약 시간 외에는 -480(UTC에서 -8시간)입니다.

선택사항 문자열

시설 (types:["establishment", ...]) 결과만 해당)의 경우 vicinity 필드에는 도로명, 번지, 지역은 포함하되 주/도, 우편번호, 국가는 포함되지 않은 장소의 단순화된 주소가 포함됩니다.

다른 모든 결과의 경우 vicinity 필드에 결과의 주소에 있는 가장 좁은 정치적 (types:["political", ...]) 기능의 이름이 포함됩니다.

이 콘텐츠는 있는 그대로 읽어야 합니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요.

선택사항 문자열

비즈니스 홈페이지와 같이 이 장소의 신뢰할 수 있는 웹사이트입니다.

선택사항 부울

장소에 휠체어 진입로가 있는지 여부를 지정합니다.

PlaceEditorialSummary

장소의 요약이 포함됩니다. 요약은 텍스트 개요로 구성되며, 해당하는 경우 이러한 언어의 언어 코드도 포함됩니다. 요약 텍스트는 있는 그대로 표시해야 하며 수정하거나 변경할 수 없습니다.

필드 필수 유형 설명
선택사항 문자열

이전 필드의 언어입니다. 항상 표시되지 않을 수 있습니다.
선택사항 문자열

장소에 대한 중간 길이의 텍스트 요약입니다.

PlaceOpeningHours

장소의 영업시간을 설명하는 객체입니다.

필드 필수 유형 설명
선택사항 부울

장소가 현재 영업 중인지 여부를 나타내는 불리언 값입니다.

선택사항 Array<PlaceOpeningHoursPeriod>

일요일부터 7일 동안의 영업 기간을 시간순으로 나타내는 배열입니다.

자세한 내용은 PlaceOpeningHoursPeriod를 참고하세요.

선택사항 Array<PlaceSpecialDay>

다음 7일에 해당하는 최대 7개의 항목 배열입니다.

자세한 내용은 PlaceSpecialDay를 참고하세요.

선택사항 문자열

보조 시간의 유형을 식별하는 데 사용되는 유형 문자열입니다 (예: DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). secondary_opening_hours에만 설정됩니다.

weekday_text

선택사항 Array<string>

사람이 읽을 수 있는 텍스트로 장소의 영업시간을 설명하는 문자열 배열입니다.

PlaceOpeningHoursPeriod

필드 필수 유형 설명
required PlaceOpeningHoursPeriodDetail

장소의 개점 시간을 나타내는 요일 및 시간 객체 쌍이 포함됩니다.

자세한 내용은 PlaceOpeningHoursPeriodDetail을 참고하세요.

선택사항 PlaceOpeningHoursPeriodDetail

장소의 폐점 시간을 나타내는 요일 및 시간 객체 쌍이 포함될 수 있습니다. 장소가 항상 열려 있는 경우 응답에서 close 섹션이 누락됩니다. 클라이언트는 항상 열려 있음을 값이 0인 요일과 값이 0000인 시간을 포함한 열린 기간으로 표시할 수 있으며 close는 없습니다.

자세한 내용은 PlaceOpeningHoursPeriodDetail을 참고하세요.

PlaceSpecialDay

필드 필수 유형 설명
선택사항 문자열

장소의 현지 시간대로 RFC3339 형식으로 표현된 날짜입니다(예: 2010-12-31).

선택사항 부울

이 날에 예외적인 시간이 있는 경우 True입니다. true인 경우 이 날짜에 하나 이상의 예외가 있음을 의미합니다. 예외로 인해 current_opening_hours 및 secondary_opening_hours의 하위 필드(예: periods, weekday_text, open_now)에 다른 값이 발생합니다. 예외는 시간에 적용되며 시간은 다른 필드를 생성하는 데 사용됩니다.

PlaceOpeningHoursPeriodDetail

필드 필수 유형 설명
required 숫자

요일에 해당하는 0~6 사이의 숫자이며 일요일부터 시작됩니다. 예를 들어, 2는 화요일을 의미합니다.

required 문자열

하루 중 시간이 24시간 hhmm 형식으로 포함될 수 있습니다. 값은 0000~2359 범위에 있습니다. 시간은 장소의 시간대로 보고됩니다.

선택사항 문자열

장소의 현지 시간대로 RFC3339 형식으로 표현된 날짜입니다(예: 2010-12-31).

선택사항 부울

요청 날짜의 자정 전에 기간이 시작되거나 마지막 날의 자정 또는 그 후에 기간이 종료되는 경우 7일 컷오프로 인해 지정된 기간이 잘렸다면 true입니다. 이 속성은 개장 또는 폐장 기간이 이 7일 기한을 넘어 연장될 수 있음을 나타냅니다.

PlacePhoto

장소 사진입니다. 다음 패턴의 URL을 사용하여 장소 사진 API를 사용하여 사진에 액세스할 수 있습니다. 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

자세한 내용은 장소 사진을 참고하세요.

필드 필수 유형 설명
required 숫자

사진의 높이입니다.
required Array<string>

사진의 HTML 저작자 표시입니다.
required 문자열

사진 요청을 실행할 때 사진을 식별하는 데 사용되는 문자열입니다.

required 숫자

사진의 너비입니다.

PlaceReview

사용자가 제출한 장소 리뷰입니다.

필드 필수 유형 설명
required 문자열

리뷰를 제출한 사용자의 이름입니다. 익명의 리뷰는 'A Google user'로 저작자가 표시됩니다.

required 숫자

이 장소에 대한 사용자의 전반적인 평점입니다. 1~5 사이의 정수입니다.

required 문자열

현재 시간을 기준으로 리뷰가 제출된 시간을 텍스트로 나타냅니다.

required 숫자

리뷰가 제출된 시간입니다. 1970년 1월 1일 자정(UTC) 이후 경과된 시간을 초 단위로 측정합니다.

선택사항 문자열

사용자의 Google 지도 지역 가이드 프로필 URL입니다(해당하는 경우).

선택사항 문자열

반환된 리뷰의 언어를 나타내는 IETF 언어 코드입니다.이 필드에는 기본 언어 태그만 포함되며, 국가나 지역을 표시하는 보조 태그는 포함되지 않습니다. 예를 들어 모든 영어 리뷰는 'en'으로만 태그가 지정되며 'en-AU'나 'en-UK' 등으로 태그가 지정되지 않습니다.리뷰 텍스트가 없는 평점만 있는 경우 이 필드는 비어 있습니다.

선택사항 문자열

리뷰의 원래 언어를 나타내는 IETF 언어 코드입니다. 리뷰가 번역된 경우 original_language != language입니다.이 필드에는 기본 언어 태그만 포함되며, 국가나 지역을 표시하는 보조 태그는 포함되지 않습니다. 예를 들어 모든 영어 리뷰는 'en'으로만 태그가 지정되며 'en-AU'나 'en-UK' 등으로 태그가 지정되지 않습니다.리뷰 텍스트가 없는 평점만 있는 경우 이 필드는 비어 있습니다.

선택사항 문자열

사용자의 프로필 사진 URL입니다(사용 가능한 경우).

text

선택사항 문자열

사용자의 리뷰입니다. Google Places에서 위치를 리뷰할 때 텍스트 리뷰는 선택사항으로 간주됩니다. 따라서 이 필드는 비어 있을 수 있습니다. 이 필드에는 기본 HTML 마크업이 포함될 수 있습니다. 예를 들어 항목 참조 &amp;는 앰퍼샌드 문자를 나타낼 수 있습니다.

선택사항 부울

리뷰가 작성된 원래 언어에서 번역되었는지 여부를 나타내는 불리언 값입니다.리뷰가 번역된 경우(true 값에 해당) Google에서는 사용자에게 이를 표시할 것을 권장합니다. 예를 들어 리뷰에 'Google에서 번역함'이라는 문자열을 추가할 수 있습니다.