รายละเอียดสถานที่ (เดิม)

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

เมื่อมี place_id จากการค้นหาสถานที่แล้ว คุณสามารถขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานที่ประกอบธุรกิจหรือจุดที่น่าสนใจที่ต้องการได้โดยเริ่มคำขอรายละเอียดสถานที่ (เดิม) คำขอรายละเอียดสถานที่ (เดิม) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่แบบเต็ม หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และรีวิว

คำขอรายละเอียดสถานที่ (เดิม)

คำขอรายละเอียดสถานที่ (เดิม) คือ HTTP URL ในรูปแบบต่อไปนี้

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

โดยที่ output อาจเป็นค่าใดค่าหนึ่งต่อไปนี้

  • json (แนะนำ) ระบุเอาต์พุตใน JavaScript Object Notation (JSON)
  • xml ระบุเอาต์พุตเป็น XML

ต้องใช้พารามิเตอร์บางอย่างเพื่อเริ่มคำขอค้นหา พารามิเตอร์ทั้งหมดจะแยกกันโดยใช้อักขระแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL ส่วนต่อไปนี้จะแสดงรายการพารามิเตอร์และค่าที่เป็นไปได้

พารามิเตอร์ที่จำเป็น

place_id

ตัวระบุแบบข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน ซึ่งแสดงผลจากการค้นหาสถานที่ (เดิม) ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่

พารามิเตอร์ที่ไม่บังคับ

Fields

ข้อควรระวัง: คำขอการค้นหาสถานที่ (เดิม) และคำขอรายละเอียดสถานที่ (เดิม) จะไม่แสดงผลฟิลด์เดียวกัน คำขอการค้นหาสถานที่ (เดิม) จะแสดงผลชุดย่อยของฟิลด์ที่แสดงผลโดยคำขอรายละเอียดสถานที่ (เดิม) หากการค้นหาสถานที่ (เดิม) ไม่แสดงช่องที่คุณต้องการ คุณสามารถใช้การค้นหาสถานที่ (เดิม) เพื่อรับ place_id จากนั้นใช้รหัสสถานที่นั้นเพื่อส่งคำขอรายละเอียดสถานที่ (เดิม) ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์ที่ใช้ไม่ได้ในคำขอการค้นหาสถานที่ (เดิม) ได้ที่ฟิลด์ข้อมูลสถานที่ (เดิม)

ใช้พารามิเตอร์ fields เพื่อระบุรายการประเภทข้อมูลสถานที่ที่คั่นด้วยคอมมาที่จะแสดงผล ตัวอย่างเช่น fields=formatted_address,name,geometry ใช้เครื่องหมายทับเมื่อระบุค่าผสม ตัวอย่างเช่น opening_hours/open_now

ช่องจะแบ่งออกเป็น 3 หมวดหมู่การเรียกเก็บเงิน ได้แก่ พื้นฐาน ข้อมูลติดต่อ และ บรรยากาศ ระบบจะเรียกเก็บเงิน SKU พื้นฐาน, SKU ข้อมูลติดต่อ และ SKU บรรยากาศเพิ่มเติมจาก SKU พื้นฐาน (รายละเอียดสถานที่, ค้นหาสถานที่, การค้นหาในบริเวณใกล้เคียง หรือการค้นหาข้อความ) สำหรับคำขอที่เรียกใช้ SKU เหล่านั้น ดูข้อมูลเพิ่มเติมได้ที่แผ่นข้อมูลราคา

Basic

หมวดหมู่พื้นฐานประกอบด้วยฟิลด์ต่อไปนี้ 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 พร้อมกับการเรียกทุกครั้ง ไม่ว่าจะมีการขอช่องดังกล่าวหรือไม่ก็ตาม

ภาษา

ภาษาที่จะแสดงผลลัพธ์

  • ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยครั้ง รายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
  • หากไม่ได้ระบุ language ไว้ API จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัว Accept-Language
  • API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
  • หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
  • ภาษาที่ต้องการมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกแสดงผลและลำดับการแสดงผล โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมายที่อาจใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของคำว่าถนนในภาษาฮังการี

ภูมิภาค

รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส 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 ระบบจะจัดเรียงรีวิวตามลำดับเวลา ภาษาที่ต้องการจะไม่ส่งผลต่อลำดับการจัดเรียง

Google ขอแนะนำให้คุณแสดงวิธีจัดเรียงรีวิวต่อผู้ใช้ปลายทาง

sessiontoken

สตริงแบบสุ่มที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน

เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์คำค้นหา และสิ้นสุดเมื่อผู้ใช้เลือกสถานที่และมีการเรียกใช้รายละเอียดสถานที่ (เดิม) แต่ละเซสชันสามารถมีคำค้นหาได้หลายรายการ ตามด้วยการเลือกสถานที่ 1 รายการ คีย์ API ที่ใช้สำหรับคำขอแต่ละรายการภายในเซสชันต้องเป็นของโปรเจ็กต์คอนโซล Google Cloud เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ระบุพารามิเตอร์ sessiontoken หรือหากคุณใช้โทเค็นของเซสชันซ้ำ ระบบจะเรียกเก็บเงินจากเซสชันเสมือนว่าไม่มีการระบุโทเค็นของเซสชัน (ระบบจะเรียกเก็บเงินแต่ละคำขอแยกกัน)

เราขอแนะนำให้ทำตามหลักเกณฑ์ต่อไปนี้

  • ใช้โทเค็นของเซสชันสำหรับเซสชันการเติมข้อความอัตโนมัติทั้งหมด
  • สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน เราขอแนะนำให้ใช้ UUID เวอร์ชัน 4
  • ตรวจสอบว่าคีย์ API ที่ใช้สำหรับคำขอ Place Autocomplete และรายละเอียดสถานที่ทั้งหมดภายในเซสชันเป็นของโปรเจ็กต์ Cloud Console เดียวกัน
  • อย่าลืมส่งโทเค็นของเซสชันที่ไม่ซ้ำกันสำหรับเซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับเซสชันมากกว่า 1 เซสชันจะส่งผลให้มีการเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน

ตัวอย่างรายละเอียดสถานที่ (เดิม)

ตัวอย่างต่อไปนี้ขอรายละเอียดของสถานที่ตาม place_id และรวมช่อง name, rating และ formatted_phone_number ไว้ด้วย

เปลือกหอย

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 ของคุณเองเพื่อให้คำขอทำงานในแอปพลิเคชันของคุณ

การตอบกลับรายละเอียดสถานที่ (เดิม)

ระบบจะแสดงผลการตอบกลับรายละเอียดสถานที่ (เดิม) ในรูปแบบที่ระบุโดยแฟล็ก output ภายในเส้นทาง URL ของคำขอ

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,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>
  <!-- ... -->
  <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

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ Array<string>

อาจมีชุดการระบุแหล่งที่มาเกี่ยวกับข้อมูลนี้ซึ่งต้องแสดงต่อผู้ใช้ (ข้อมูลบางรายการอาจไม่มีการระบุแหล่งที่มา)

ต้องระบุ Place

มีข้อมูลโดยละเอียดเกี่ยวกับสถานที่ที่ขอ

ดูข้อมูลเพิ่มเติมได้ที่สถานที่

ต้องระบุ PlacesDetailsStatus

มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่องเพื่อช่วยคุณติดตามสาเหตุที่คำขอล้มเหลว

ดูข้อมูลเพิ่มเติมได้ที่ PlacesDetailsStatus

ไม่บังคับ Array<string>

เมื่อบริการแสดงข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของคำขอ อาจมีช่อง info_messages เพิ่มเติมภายในออบเจ็กต์การตอบกลับ ระบบจะแสดงช่องนี้สําหรับคําขอที่สําเร็จเท่านั้น ระบบอาจไม่แสดงผลเสมอไป และเนื้อหาอาจมีการเปลี่ยนแปลง

ในการตอบกลับ JSON ข้อมูลเหล่านี้จะแสดงเป็นองค์ประกอบรูท ในการตอบกลับ XML รายการเหล่านี้จะปรากฏเป็นองค์ประกอบระดับบนสุดใต้ <PlaceDetailsResponse>

PlacesDetailsStatus

รหัสสถานะที่บริการแสดงผล

  • OK ซึ่งบ่งบอกว่าคำขอ API สำเร็จแล้ว
  • ZERO_RESULTS ซึ่งระบุว่าตำแหน่งที่อ้างอิง place_id ถูกต้อง แต่ไม่ได้อ้างอิงถึงผลลัพธ์ที่ถูกต้องอีกต่อไป กรณีนี้อาจเกิดขึ้นหากสถานที่ประกอบธุรกิจเลิกกิจการแล้ว
  • NOT_FOUND ซึ่งระบุว่าไม่พบสถานที่ที่อ้างอิง place_id ในฐานข้อมูล Places
  • INVALID_REQUEST ซึ่งระบุว่าคำขอ API มีรูปแบบไม่ถูกต้อง
  • OVER_QUERY_LIMIT ที่ระบุถึงสิ่งต่อไปนี้
    • คุณใช้ QPS เกินขีดจำกัดแล้ว
    • ยังไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชีของคุณ
    • เครดิตรายเดือน $200 หรือขีดจำกัดการใช้งานที่กำหนดเองเกินขีดจำกัดแล้ว
    • วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
    ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขข้อผิดพลาดนี้ได้ที่คำถามที่พบบ่อยเกี่ยวกับ Maps
  • REQUEST_DENIED ซึ่งระบุว่าคำขอของคุณถูกปฏิเสธ โดยทั่วไปแล้วเป็นเพราะสาเหตุต่อไปนี้
    • คำขอไม่มีคีย์ API
    • พารามิเตอร์ key ไม่ถูกต้อง
  • UNKNOWN_ERROR ซึ่งบ่งบอกถึงข้อผิดพลาดที่ไม่รู้จัก

สถานที่

แอตทริบิวต์ที่อธิบายสถานที่ แอตทริบิวต์บางรายการอาจใช้ไม่ได้กับสถานที่บางประเภท

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ Array<AddressComponent>

อาร์เรย์ที่มีคอมโพเนนต์แยกต่างหากที่ใช้กับที่อยู่นี้

ดูข้อมูลเพิ่มเติมได้ที่ AddressComponent

ไม่บังคับ สตริง

การแสดงที่อยู่ของสถานที่ในไมโครฟอร์แมต adr

ไม่บังคับ สตริง

ระบุสถานะการดำเนินการของสถานที่ หากเป็นธุรกิจ หากไม่มีข้อมูล ระบบจะไม่แสดงผล business_status

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
ไม่บังคับ บูลีน

ระบุว่าธุรกิจรองรับการรับสินค้าโดยไม่ต้องลงจากรถหรือไม่

ไม่บังคับ PlaceOpeningHours

มีเวลาทำการสำหรับ 7 วันถัดไป (รวมถึงวันนี้) ระยะเวลาจะเริ่มตั้งแต่เที่ยงคืนของวันที่ส่งคำขอและสิ้นสุดเวลา 23:59 น. ในอีก 6 วันต่อมา ช่องนี้มีช่องย่อย special_days ของเวลาทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ

ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours

ไม่บังคับ บูลีน

ระบุว่าธุรกิจรองรับการนำส่งหรือไม่

ไม่บังคับ บูลีน

ระบุว่าธุรกิจรองรับตัวเลือกที่นั่งในร่มหรือกลางแจ้งหรือไม่

ไม่บังคับ PlaceEditorialSummary

มีข้อมูลสรุปเกี่ยวกับสถานที่ ข้อมูลสรุปประกอบด้วยภาพรวมที่เป็นข้อความ และยังมีรหัสภาษาสำหรับข้อมูลเหล่านี้ด้วย (หากมี) ข้อความสรุปต้องแสดงตามที่เป็นอยู่และไม่สามารถแก้ไขหรือเปลี่ยนแปลงได้

ดูข้อมูลเพิ่มเติมได้ที่ PlaceEditorialSummary

ไม่บังคับ สตริง

สตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้

ซึ่งมักจะเป็นที่อยู่เดียวกับที่อยู่ทางไปรษณีย์ โปรดทราบว่าบางประเทศ เช่น สหราชอาณาจักร ไม่อนุญาตให้เผยแพร่ที่อยู่ทางไปรษณีย์จริงเนื่องจากข้อจำกัดด้านการอนุญาตให้ใช้สิทธิ

ที่อยู่ซึ่งจัดรูปแบบแล้วประกอบด้วยคอมโพเนนต์ที่อยู่อย่างน้อย 1 รายการตามหลักตรรกะ ตัวอย่างเช่น ที่อยู่ "111 8th Avenue, New York, NY" ประกอบด้วยองค์ประกอบต่อไปนี้ "111" (เลขที่) "8th Avenue" (เส้นทาง) "New York" (เมือง) และ "NY" (รัฐในสหรัฐอเมริกา)

อย่าแยกวิเคราะห์ที่อยู่ซึ่งจัดรูปแบบแล้วแบบเป็นโปรแกรม แต่ควรใช้คอมโพเนนต์ที่อยู่แต่ละรายการ ซึ่งการตอบกลับจาก API จะรวมไว้นอกเหนือจากช่องที่อยู่ที่จัดรูปแบบแล้ว

ไม่บังคับ สตริง

มีหมายเลขโทรศัพท์ของสถานที่ในรูปแบบท้องถิ่น

ไม่บังคับ Geometry

มีตำแหน่งและวิวพอร์ตสำหรับตำแหน่ง

ดูข้อมูลเพิ่มเติมได้ที่ Geometry

ไม่บังคับ สตริง

มี URL ของไอคอนที่แนะนำซึ่งอาจแสดงต่อผู้ใช้เมื่อระบุผลการค้นหานี้บนแผนที่

ไม่บังคับ สตริง

มีรหัสสีแบบเลขฐาน 16 เริ่มต้นสำหรับหมวดหมู่ของสถานที่

ไม่บังคับ สตริง

มี URL ของไอคอนที่แนะนำ โดยไม่มีนามสกุลประเภทไฟล์ .svg หรือ .png

ไม่บังคับ สตริง

มีหมายเลขโทรศัพท์ของสถานที่ในรูปแบบระหว่างประเทศ รูปแบบระหว่างประเทศประกอบด้วยรหัสประเทศและขึ้นต้นด้วยเครื่องหมายบวก (+) ตัวอย่างเช่น international_phone_number ของสำนักงาน Google ในซิดนีย์ ประเทศออสเตรเลียคือ +61 2 9374 4000

ไม่บังคับ สตริง

มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดงผล สำหรับผลการค้นหา establishment โดยปกติแล้วจะเป็นชื่อธุรกิจที่ทำ Canonical

ไม่บังคับ PlaceOpeningHours

มีเวลาทำการปกติ

ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours

ไม่บังคับ บูลีน

ใช้ business_status เพื่อดูสถานะการดำเนินการของธุรกิจ

ไม่บังคับ Array<PlacePhoto>

อาร์เรย์ของออบเจ็กต์รูปภาพ ซึ่งแต่ละออบเจ็กต์มีการอ้างอิงถึงรูปภาพ คำขออาจแสดงรูปภาพได้สูงสุด 10 รูป ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปภาพสถานที่และวิธีใช้รูปภาพในแอปพลิเคชันได้ในเอกสารประกอบเกี่ยวกับรูปภาพสถานที่

ดูข้อมูลเพิ่มเติมได้ที่ PlacePhoto

ไม่บังคับ สตริง

ตัวระบุข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน หากต้องการดึงข้อมูลเกี่ยวกับสถานที่ ให้ส่งตัวระบุนี้ในช่อง place_id ของคำขอ Places API ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่

ไม่บังคับ PlusCode

การอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูดที่แสดงพื้นที่: 1/8, 000 ขององศา x 1/8, 000 ขององศา (ประมาณ 14 ม. x 14 ม. ที่เส้นศูนย์สูตร) หรือเล็กกว่านั้น Plus Codes สามารถใช้แทนที่อยู่ได้ในสถานที่ที่ไม่มีที่อยู่ (สถานที่ที่อาคารไม่มีหมายเลขหรือถนนไม่มีชื่อ) ดูรหัสตำแหน่งแบบเปิดและ Plus Code

ดูข้อมูลเพิ่มเติมได้ที่ PlusCode

ไม่บังคับ ตัวเลข

ระดับราคาของสถานที่ในระดับ 0 ถึง 4 จำนวนเงินที่แน่นอนซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค ระบบจะตีความระดับราคาดังนี้

  • 0 รายการที่ไม่มีค่าใช้จ่าย
  • 1 ไม่แพง
  • 2 ปานกลาง
  • 3 แพง
  • 4 แพงมาก
ไม่บังคับ ตัวเลข

มีคะแนนของสถานที่ตั้งแต่ 1.0 ถึง 5.0 โดยอิงตามรีวิวจากผู้ใช้ที่รวบรวมไว้

ไม่บังคับ สตริง
ไม่บังคับ บูลีน

ระบุว่าสถานที่รองรับการจองหรือไม่

ไม่บังคับ Array<PlaceReview>

อาร์เรย์ JSON ของรีวิวสูงสุด 5 รายการ โดยค่าเริ่มต้น ระบบจะจัดเรียงรีวิวตามลำดับความเกี่ยวข้อง ใช้พารามิเตอร์คำขอ reviews_sort เพื่อควบคุมการจัดเรียง

  • สำหรับ most_relevant (ค่าเริ่มต้น) ระบบจะจัดเรียงรีวิวตามความเกี่ยวข้อง โดยบริการจะให้น้ำหนักกับผลการค้นหาเพื่อแสดงรีวิวที่เขียนขึ้นในภาษาที่ต้องการเป็นหลัก
  • สำหรับ newest ระบบจะจัดเรียงรีวิวตามลำดับเวลา ภาษาที่ต้องการจะไม่ส่งผลต่อลำดับการจัดเรียง

Google ขอแนะนำให้ระบุให้ผู้ใช้ทราบว่าผลการค้นหาจัดเรียงตามmost_relevantหรือnewest

ดูข้อมูลเพิ่มเติมได้ที่ PlaceReview

ไม่บังคับ สตริง
ไม่บังคับ Array<PlaceOpeningHours>

มีอาร์เรย์ของรายการสำหรับ 7 วันถัดไป รวมถึงข้อมูลเกี่ยวกับเวลาทำการรองของธุรกิจ เวลาทำการรองจะแตกต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหารสามารถระบุเวลาทำการของไดรฟ์ทรูหรือเวลาทำการของบริการจัดส่งเป็นเวลาทำการรองได้ ช่องนี้จะป้อนข้อมูลในช่องย่อย type ซึ่งดึงข้อมูลจากรายการประเภทเวลาทำการที่กำหนดไว้ล่วงหน้า (เช่น DRIVE_THROUGH, PICKUP หรือ TAKEOUT) ตามประเภทของสถานที่ ช่องนี้มีช่องย่อย special_days ของเวลาทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ

ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours

ไม่บังคับ บูลีน

ระบุว่าสถานที่นั้นเสิร์ฟเบียร์หรือไม่

ไม่บังคับ บูลีน

ระบุว่าสถานที่ให้บริการอาหารเช้าหรือไม่

ไม่บังคับ บูลีน

ระบุว่าสถานที่ให้บริการอาหารมื้อสายหรือไม่

ไม่บังคับ บูลีน

ระบุว่าสถานที่ให้บริการอาหารเย็นหรือไม่

ไม่บังคับ บูลีน

ระบุว่าสถานที่ให้บริการอาหารกลางวันหรือไม่

ไม่บังคับ บูลีน

ระบุว่าสถานที่นั้นเสิร์ฟอาหารมังสวิรัติหรือไม่

ไม่บังคับ บูลีน

ระบุว่าสถานที่เสิร์ฟไวน์หรือไม่

ไม่บังคับ บูลีน

ระบุว่าธุรกิจรองรับการสั่งกลับบ้านหรือไม่

ไม่บังคับ Array<string>

มีอาร์เรย์ของประเภทฟีเจอร์ที่อธิบายผลลัพธ์ที่ระบุ ดูรายการประเภทที่รองรับ

ไม่บังคับ สตริง

มี URL ของหน้า Google อย่างเป็นทางการสำหรับสถานที่นี้ ซึ่งจะเป็นหน้าเว็บที่ Google เป็นเจ้าของและมีข้อมูลที่ดีที่สุดเกี่ยวกับสถานที่นั้น แอปพลิเคชันต้องลิงก์หรือฝังหน้านี้ในหน้าจอใดก็ตามที่แสดงผลลัพธ์โดยละเอียดเกี่ยวกับสถานที่ต่อผู้ใช้

ไม่บังคับ ตัวเลข

จำนวนรีวิวทั้งหมด (แบบมีหรือไม่มีข้อความ) สำหรับสถานที่นี้

ไม่บังคับ ตัวเลข

มีจำนวนนาทีที่เขตเวลาปัจจุบันของสถานที่นี้ชดเชยจาก UTC เช่น สำหรับสถานที่ในซิดนีย์ ประเทศออสเตรเลีย ในช่วงเวลาออมแสง ค่านี้จะเป็น 660 (+11 ชั่วโมงจาก UTC) และสำหรับสถานที่ในแคลิฟอร์เนียนอกช่วงเวลาออมแสง ค่านี้จะเป็น -480 (-8 ชั่วโมงจาก UTC)

ไม่บังคับ สตริง

สำหรับผลลัพธ์ของสถานประกอบการ (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 เท่านั้น

ไม่บังคับ Array<string>

อาร์เรย์ของสตริงที่อธิบายเวลาทำการของสถานที่ในรูปแบบข้อความที่มนุษย์อ่านได้

PlaceOpeningHoursPeriod

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ PlaceOpeningHoursPeriodDetail

มีออบเจ็กต์วันและเวลาคู่หนึ่งที่อธิบายเวลาที่สถานที่เปิดทำการ

ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriodDetail

ไม่บังคับ PlaceOpeningHoursPeriodDetail

อาจมีออบเจ็กต์วันและเวลาคู่หนึ่งที่อธิบายเวลาที่สถานที่ปิด หากสถานที่เปิดตลอดเวลา ส่วนปิดจะหายไปจากการตอบกลับ ไคลเอ็นต์สามารถใช้ข้อมูลที่แสดงว่าเปิดตลอดเวลาเป็นระยะเวลาเปิดที่มีวันซึ่งมีค่า 0 และเวลาซึ่งมีค่า 0000 และไม่มี close

ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriodDetail

PlaceSpecialDay

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ สตริง

วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31

ไม่บังคับ บูลีน

เป็นจริงหากมีเวลาทำการพิเศษสำหรับวันนี้ หาก true หมายความว่ามีข้อยกเว้นอย่างน้อย 1 รายการสำหรับวันนี้ ข้อยกเว้นทำให้เกิดค่าที่แตกต่างกันในฟิลด์ย่อยของ current_opening_hours และ secondary_opening_hours เช่น periods, weekday_text, open_now ข้อยกเว้นจะมีผลกับเวลาทำการ และระบบจะใช้เวลาทำการเพื่อสร้างฟิลด์อื่นๆ

PlaceOpeningHoursPeriodDetail

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ ตัวเลข

ตัวเลขตั้งแต่ 0-6 ซึ่งสอดคล้องกับวันในสัปดาห์ โดยเริ่มตั้งแต่วันอาทิตย์ เช่น 2 หมายถึงวันอังคาร

ต้องระบุ สตริง

อาจมีเวลาของวันในรูปแบบ hhmm แบบ 24 ชั่วโมง ค่าจะอยู่ในช่วง 0000-2359 ระบบจะรายงานเวลาตามเขตเวลาของสถานที่นั้นๆ

ไม่บังคับ สตริง

วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31

ไม่บังคับ บูลีน

เป็นจริงหากระยะเวลาที่ระบุถูกตัดให้สั้นลงเนื่องจากมีระยะเวลาสูงสุด 7 วัน โดยระยะเวลาจะเริ่มต้นก่อนเที่ยงคืนของวันที่ส่งคำขอ และ/หรือสิ้นสุดที่หรือหลังเที่ยงคืนของวันสุดท้าย พร็อพเพอร์ตี้นี้ระบุว่าระยะเวลาเปิดหรือปิดสามารถขยายเกินช่วงเวลา 7 วันนี้ได้

PlacePhoto

รูปภาพของสถานที่ คุณเข้าถึงรูปภาพได้โดยใช้ Place Photo API โดยใช้ URL ในรูปแบบต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่รูปภาพสถานที่

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ ตัวเลข

ความสูงของรูปภาพ

ต้องระบุ Array<string>

แอตทริบิวต์ HTML สำหรับรูปภาพ

ต้องระบุ สตริง

สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอรูปภาพ

ต้องระบุ ตัวเลข

ความกว้างของรูปภาพ

PlaceReview

รีวิวสถานที่ที่ผู้ใช้ส่งมา

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ สตริง

ชื่อของผู้ใช้ที่ส่งรีวิว รีวิวที่ไม่ระบุตัวตนจะระบุว่าเป็นของ "ผู้ใช้ Google"

ต้องระบุ ตัวเลข

คะแนนโดยรวมที่ผู้ใช้ให้แก่สถานที่นี้ ซึ่งเป็นจำนวนเต็มตั้งแต่ 1 ถึง 5

ต้องระบุ สตริง

เวลาที่ส่งรีวิวในรูปแบบข้อความ โดยสัมพันธ์กับเวลาปัจจุบัน

ต้องระบุ ตัวเลข

เวลาที่ส่งรีวิว โดยวัดเป็นจำนวนวินาทีนับตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 ตามเวลา UTC

ไม่บังคับ สตริง

URL ของโปรไฟล์ Local Guides ใน Google Maps ของผู้ใช้ (หากมี)

ไม่บังคับ สตริง

รหัสภาษา IETF ที่ระบุภาษาของรีวิวที่แสดงผล ช่องนี้มีเฉพาะแท็กภาษาหลักเท่านั้น และไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดจะติดแท็กเป็น "en" ไม่ใช่ "en-AU" หรือ "en-UK" เป็นต้น ช่องนี้จะว่างเปล่าหากมีเพียงคะแนนโดยไม่มีข้อความรีวิว

ไม่บังคับ สตริง

รหัสภาษา IETF ที่ระบุภาษาต้นฉบับของรีวิว หากรีวิวได้รับการแปลแล้ว original_language != language ช่องนี้จะมีเฉพาะแท็กภาษาหลักเท่านั้น และไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดจะติดแท็กเป็น "en" ไม่ใช่ "en-AU" หรือ "en-UK" เป็นต้น ช่องนี้จะว่างเปล่าหากมีเพียงคะแนนโดยไม่มีข้อความรีวิว

ไม่บังคับ สตริง

URL ของรูปโปรไฟล์ของผู้ใช้ (หากมี)

ไม่บังคับ สตริง

รีวิวของผู้ใช้ เมื่อรีวิวสถานที่ด้วย Google Places ระบบจะถือว่ารีวิวแบบข้อความเป็นตัวเลือกที่ไม่บังคับ ดังนั้น ช่องนี้จึงอาจว่างเปล่า โปรดทราบว่าช่องนี้อาจรวมมาร์กอัป HTML พื้นฐาน เช่น การอ้างอิงเอนทิตี &amp; อาจแสดงถึงอักขระเครื่องหมายแอมเพอร์แซนด์

ไม่บังคับ บูลีน

ค่าบูลีนที่ระบุว่ารีวิวได้รับการแปลจากภาษาต้นฉบับที่เขียนหรือไม่ หากรีวิวได้รับการแปลซึ่งสอดคล้องกับค่าเป็นจริง Google ขอแนะนำให้คุณระบุข้อมูลนี้แก่ผู้ใช้ เช่น คุณสามารถเพิ่มสตริง "แปลโดย Google" ต่อไปนี้ลงในรีวิวได้