This product is in Legacy status. As of October 2026, Places API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to Places API (New).

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

หมายเหตุ: ไลบรารีฝั่งเซิร์ฟเวอร์และฝั่งไคลเอ็นต์

Places API ยังใช้ได้กับไคลเอ็นต์ Java, ไคลเอ็นต์ Python, ไคลเอ็นต์ Go และไคลเอ็นต์ Node.js สำหรับบริการ Google Maps ด้วย Places API และไลบรารีของไคลเอ็นต์มีไว้เพื่อใช้ในแอปพลิเคชันเซิร์ฟเวอร์

หากคุณกำลังสร้างแอปพลิเคชันฝั่งไคลเอ็นต์ โปรดดู Places SDK สำหรับ Android (ใหม่), Places SDK สำหรับ iOS (ใหม่) และคลัง Places, Maps JavaScript API

เมื่อมี 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 เซสชันจะส่งผลให้ระบบเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน

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

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

ตัวอย่างต่อไปนี้ขอรายละเอียดของสถานที่ตาม 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

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`html_attributions`	ต้องระบุ	Array<string>	อาจมีชุดการระบุแหล่งที่มาเกี่ยวกับข้อมูลนี้ซึ่งต้องแสดงต่อผู้ใช้ (ข้อมูลบางรายการอาจไม่มีการระบุแหล่งที่มา)
`result`	ต้องระบุ	Place	มีข้อมูลโดยละเอียดเกี่ยวกับสถานที่ที่ขอ ดูข้อมูลเพิ่มเติมได้ที่สถานที่
`status`	ต้องระบุ	PlacesDetailsStatus	มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่องเพื่อช่วยคุณติดตามสาเหตุที่คำขอล้มเหลว ดูข้อมูลเพิ่มเติมได้ที่ PlacesDetailsStatus
`info_messages`	ไม่บังคับ	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 ซึ่งบ่งบอกถึงข้อผิดพลาดที่ไม่รู้จัก

สถานที่

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

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`address_components`	ไม่บังคับ	Array<`AddressComponent`>	อาร์เรย์ที่มีองค์ประกอบแยกต่างหากที่ใช้กับที่อยู่นี้ ดูข้อมูลเพิ่มเติมได้ที่ `AddressComponent`
`adr_address`	ไม่บังคับ	สตริง	การแสดงที่อยู่ของสถานที่ในไมโครฟอร์แมต adr
`business_status`	ไม่บังคับ	สตริง	ระบุสถานะการดำเนินการของสถานที่ หากเป็นธุรกิจ หากไม่มีข้อมูล ระบบจะไม่แสดง `business_status` The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับการรับสินค้าโดยไม่ต้องลงจากรถหรือไม่
`current_opening_hours`	ไม่บังคับ	PlaceOpeningHours	มีเวลาทำการสำหรับ 7 วันถัดไป (รวมถึงวันนี้) ระยะเวลาจะเริ่มต้นที่เที่ยงคืนของวันที่ส่งคำขอและสิ้นสุดที่เวลา 23:59 น. ในอีก 6 วันต่อมา ช่องนี้มีช่องย่อย `special_days` ของเวลาทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours
`delivery`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับการนำส่งหรือไม่
`dine_in`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับตัวเลือกที่นั่งในร่มหรือกลางแจ้งหรือไม่
`editorial_summary`	ไม่บังคับ	PlaceEditorialSummary	มีข้อมูลสรุปเกี่ยวกับสถานที่ ข้อมูลสรุปประกอบด้วยภาพรวมที่เป็นข้อความ และยังมีรหัสภาษาสำหรับข้อมูลเหล่านี้ด้วย (หากมี) ข้อความสรุปต้องแสดงตามที่เป็นอยู่และไม่สามารถแก้ไขหรือเปลี่ยนแปลงได้ ดูข้อมูลเพิ่มเติมได้ที่ PlaceEditorialSummary
`formatted_address`	ไม่บังคับ	สตริง	สตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้ ซึ่งมักจะเป็นที่อยู่เดียวกับที่อยู่ทางไปรษณีย์ โปรดทราบว่าบางประเทศ เช่น สหราชอาณาจักร ไม่อนุญาตให้เผยแพร่ที่อยู่ทางไปรษณีย์จริงเนื่องจากข้อจำกัดด้านการอนุญาตให้ใช้สิทธิ ที่อยู่ซึ่งจัดรูปแบบแล้วประกอบด้วยคอมโพเนนต์ที่อยู่อย่างน้อย 1 รายการตามหลักตรรกะ ตัวอย่างเช่น ที่อยู่ "111 8th Avenue, New York, NY" ประกอบด้วยองค์ประกอบต่อไปนี้ "111" (เลขที่ถนน) "8th Avenue" (เส้นทาง) "New York" (เมือง) และ "NY" (รัฐในสหรัฐอเมริกา) อย่าแยกวิเคราะห์ที่อยู่ซึ่งจัดรูปแบบแล้วแบบเป็นโปรแกรม แต่ควรใช้คอมโพเนนต์ที่อยู่แต่ละรายการ ซึ่งการตอบกลับจาก API จะรวมไว้นอกเหนือจากช่องที่อยู่ที่จัดรูปแบบแล้ว
`formatted_phone_number`	ไม่บังคับ	สตริง	มีหมายเลขโทรศัพท์ของสถานที่ในรูปแบบท้องถิ่น
`geometry`	ไม่บังคับ	`Geometry`	มีตำแหน่งและวิวพอร์ตสำหรับตำแหน่ง ดูข้อมูลเพิ่มเติมได้ที่ `Geometry`
`icon`	ไม่บังคับ	สตริง	มี URL ของไอคอนที่แนะนำซึ่งอาจแสดงต่อผู้ใช้เมื่อระบุผลการค้นหานี้บนแผนที่
`icon_background_color`	ไม่บังคับ	สตริง	มีรหัสสีแบบเลขฐาน 16 เริ่มต้นสำหรับหมวดหมู่ของสถานที่
`icon_mask_base_uri`	ไม่บังคับ	สตริง	มี URL ของไอคอนที่แนะนำ โดยไม่มีนามสกุลประเภทไฟล์ `.svg` หรือ `.png`
`international_phone_number`	ไม่บังคับ	สตริง	มีหมายเลขโทรศัพท์ของสถานที่ในรูปแบบระหว่างประเทศ รูปแบบระหว่างประเทศประกอบด้วยรหัสประเทศ และขึ้นต้นด้วยเครื่องหมายบวก (+) ตัวอย่างเช่น international_phone_number ของสำนักงาน Google ในซิดนีย์ ประเทศออสเตรเลียคือ `+61 2 9374 4000`
`name`	ไม่บังคับ	สตริง	มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดงผล สำหรับผลการค้นหา `establishment` โดยปกติแล้วจะเป็นชื่อธุรกิจที่ทำ Canonical
`opening_hours`	ไม่บังคับ	PlaceOpeningHours	มีเวลาทำการปกติ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours
`permanently_closed`	ไม่บังคับ	บูลีน	`permanently_closed` เลิกใช้งานแล้ว ใช้ `business_status` เพื่อดูสถานะการดำเนินการของธุรกิจ
`photos`	ไม่บังคับ	Array<PlacePhoto>	อาร์เรย์ของออบเจ็กต์รูปภาพ ซึ่งแต่ละออบเจ็กต์มีการอ้างอิงถึงรูปภาพ คำขออาจแสดงผลรูปภาพได้สูงสุด 10 รูป ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปภาพสถานที่และวิธีใช้รูปภาพในแอปพลิเคชันได้ในเอกสารประกอบเกี่ยวกับรูปภาพสถานที่ ดูข้อมูลเพิ่มเติมได้ที่ PlacePhoto
`place_id`	ไม่บังคับ	สตริง	ตัวระบุข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน หากต้องการดึงข้อมูลเกี่ยวกับสถานที่ ให้ส่งตัวระบุนี้ในช่อง `place_id` ของคำขอ Places API ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่
`plus_code`	ไม่บังคับ	`PlusCode`	ข้อมูลอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูดที่แสดงพื้นที่: 1/8, 000 ขององศา x 1/8, 000 ขององศา (ประมาณ 14 ม. x 14 ม. ที่เส้นศูนย์สูตร) หรือเล็กกว่านั้น Plus Codes สามารถใช้แทนที่อยู่ได้ในสถานที่ที่ไม่มีที่อยู่ (สถานที่ที่อาคารไม่มีหมายเลขหรือถนนไม่มีชื่อ) ดูรหัสตำแหน่งแบบเปิดและ Plus Code ดูข้อมูลเพิ่มเติมได้ที่ `PlusCode`
`price_level`	ไม่บังคับ	ตัวเลข	ระดับราคาของสถานที่ในระดับ 0 ถึง 4 จำนวนเงินที่แน่นอนซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค ระบบจะตีความระดับราคาดังนี้ 0 รายการที่ไม่มีค่าใช้จ่าย 1 ไม่แพง 2 ปานกลาง 3 แพง 4 แพงมาก
`rating`	ไม่บังคับ	ตัวเลข	มีคะแนนของสถานที่ตั้งแต่ 1.0 ถึง 5.0 โดยอิงตามรีวิวจากผู้ใช้ที่รวบรวมไว้
`reference`	ไม่บังคับ	สตริง	`reference` เลิกใช้งานแล้ว
`reservable`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่รองรับการจองหรือไม่
`reviews`	ไม่บังคับ	Array<PlaceReview>	อาร์เรย์ JSON ของรีวิวสูงสุด 5 รายการ โดยค่าเริ่มต้น ระบบจะจัดเรียงรีวิวตามลำดับความเกี่ยวข้อง ใช้พารามิเตอร์คำขอ `reviews_sort` เพื่อควบคุมการจัดเรียง สำหรับ `most_relevant` (ค่าเริ่มต้น) รีวิวจะจัดเรียงตามความเกี่ยวข้อง โดยบริการจะให้น้ำหนักกับผลการค้นหาเพื่อแสดงรีวิวที่เขียนเป็นภาษาที่ต้องการตั้งแต่แรก สำหรับ `newest` ระบบจะจัดเรียงรีวิวตามลำดับเวลา ภาษาที่ต้องการจะไม่ส่งผลต่อลำดับการจัดเรียง Google ขอแนะนำให้ระบุให้ผู้ใช้ทราบว่าผลการค้นหาจัดเรียงตาม`most_relevant`หรือ`newest` ดูข้อมูลเพิ่มเติมได้ที่ PlaceReview
`scope`	ไม่บังคับ	สตริง	`scope` เลิกใช้งานแล้ว
`secondary_opening_hours`	ไม่บังคับ	Array<PlaceOpeningHours>	มีอาร์เรย์ของรายการสำหรับ 7 วันถัดไป รวมถึงข้อมูลเกี่ยวกับเวลาทำการรองของธุรกิจ เวลาทำการรองจะแตกต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหารสามารถระบุเวลาทำการของไดรฟ์ทรูหรือเวลาทำการของบริการจัดส่งเป็นเวลาทำการรองได้ ช่องนี้จะป้อนข้อมูลในช่องย่อย `type` ซึ่งดึงข้อมูลจากรายการประเภทเวลาทำการที่กำหนดไว้ล่วงหน้า (เช่น `DRIVE_THROUGH`, `PICKUP` หรือ `TAKEOUT`) ตามประเภทของสถานที่ ช่องนี้มีช่องย่อย `special_days` ของเวลาทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours
`serves_beer`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นั้นเสิร์ฟเบียร์หรือไม่
`serves_breakfast`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารเช้าหรือไม่
`serves_brunch`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารมื้อสายหรือไม่
`serves_dinner`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารเย็นหรือไม่
`serves_lunch`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารกลางวันหรือไม่
`serves_vegetarian_food`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นั้นเสิร์ฟอาหารมังสวิรัติหรือไม่
`serves_wine`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่เสิร์ฟไวน์หรือไม่
`takeout`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับการซื้อกลับบ้านหรือไม่
`types`	ไม่บังคับ	Array<string>	มีอาร์เรย์ของประเภทฟีเจอร์ที่อธิบายผลลัพธ์ที่ระบุ ดูรายการประเภทที่รองรับ
`url`	ไม่บังคับ	สตริง	มี URL ของหน้า Google อย่างเป็นทางการสำหรับสถานที่นี้ ซึ่งจะเป็นหน้าเว็บที่ Google เป็นเจ้าของและมีข้อมูลที่ดีที่สุดเกี่ยวกับสถานที่นั้น แอปพลิเคชันต้องลิงก์หรือฝังหน้านี้ในหน้าจอใดก็ตามที่แสดงผลลัพธ์โดยละเอียดเกี่ยวกับสถานที่ต่อผู้ใช้
`user_ratings_total`	ไม่บังคับ	ตัวเลข	จำนวนรีวิวทั้งหมด (แบบมีหรือไม่มีข้อความ) สำหรับสถานที่นี้
`utc_offset`	ไม่บังคับ	ตัวเลข	มีจำนวนนาทีที่เขตเวลาปัจจุบันของสถานที่นี้ชดเชยจาก UTC เช่น สำหรับสถานที่ในซิดนีย์ ประเทศออสเตรเลีย ในช่วงเวลาออมแสง ค่านี้จะเป็น 660 (+11 ชั่วโมงจาก UTC) และสำหรับสถานที่ในแคลิฟอร์เนียนอกเวลาออมแสง ค่านี้จะเป็น -480 (-8 ชั่วโมงจาก UTC)
`vicinity`	ไม่บังคับ	สตริง	สำหรับผลลัพธ์ของสถานประกอบการ (`types:["establishment", ...])` เท่านั้น ช่อง `vicinity` จะมีที่อยู่แบบย่อของสถานที่ ซึ่งรวมถึงชื่อถนน หมายเลขถนน และท้องถิ่น แต่ไม่รวมจังหวัด/รัฐ รหัสไปรษณีย์ หรือประเทศ สำหรับผลลัพธ์อื่นๆ ทั้งหมด ช่อง `vicinity` จะมีชื่อของฟีเจอร์ทางการเมือง (`types:["political", ...]`) ที่แคบที่สุดซึ่งแสดงอยู่ในที่อยู่ของผลลัพธ์ เนื้อหานี้มีไว้เพื่อให้อ่านตามที่เป็นอยู่ อย่าแยกวิเคราะห์ที่อยู่ซึ่งจัดรูปแบบแล้วแบบเป็นโปรแกรม
`website`	ไม่บังคับ	สตริง	เว็บไซต์ที่เชื่อถือได้สำหรับสถานที่นี้ เช่น หน้าแรกของธุรกิจ
`wheelchair_accessible_entrance`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นั้นมีทางเข้าที่รองรับเก้าอี้รถเข็นหรือไม่

PlaceEditorialSummary

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

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`language`	ไม่บังคับ	สตริง	ภาษาของช่องก่อนหน้า อาจไม่แสดงเสมอไป
`overview`	ไม่บังคับ	สตริง	ข้อความสรุปความยาวปานกลางเกี่ยวกับสถานที่

PlaceOpeningHours

ออบเจ็กต์ที่อธิบายเวลาทำการของสถานที่

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`open_now`	ไม่บังคับ	บูลีน	ค่าบูลีนที่ระบุว่าสถานที่เปิดอยู่ในเวลาปัจจุบันหรือไม่
`periods`	ไม่บังคับ	Array<PlaceOpeningHoursPeriod>	อาร์เรย์ของช่วงเวลาเปิดทำการที่ครอบคลุม 7 วัน โดยเริ่มตั้งแต่วันอาทิตย์ตามลำดับเวลา ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriod
`special_days`	ไม่บังคับ	Array<PlaceSpecialDay>	อาร์เรย์ของรายการสูงสุด 7 รายการที่สอดคล้องกับ 7 วันถัดไป ดูข้อมูลเพิ่มเติมได้ที่ PlaceSpecialDay
`type`	ไม่บังคับ	สตริง	สตริงประเภทที่ใช้ระบุประเภทของเวลาทำการรอง (เช่น `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`) ตั้งค่าสำหรับ `secondary_opening_hours` เท่านั้น
`weekday_text`	ไม่บังคับ	Array<string>	อาร์เรย์ของสตริงที่อธิบายเวลาทำการของสถานที่ในรูปแบบข้อความที่มนุษย์อ่านได้

PlaceOpeningHoursPeriod

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

PlaceSpecialDay

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`date`	ไม่บังคับ	สตริง	วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31
`exceptional_hours`	ไม่บังคับ	บูลีน	เป็นจริงหากมีเวลาทำการพิเศษสำหรับวันนี้ หากเป็น `true` หมายความว่ามีข้อยกเว้นอย่างน้อย 1 รายการสำหรับวันนี้ ข้อยกเว้นทำให้เกิดค่าที่แตกต่างกันในฟิลด์ย่อยของ `current_opening_hours` และ `secondary_opening_hours` เช่น `periods`, `weekday_text`, `open_now` ข้อยกเว้นจะมีผลกับเวลาทำการ และระบบจะใช้เวลาทำการเพื่อสร้างฟิลด์อื่นๆ

PlaceOpeningHoursPeriodDetail

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`day`	ต้องระบุ	ตัวเลข	ตัวเลขตั้งแต่ 0-6 ซึ่งสอดคล้องกับวันในสัปดาห์ โดยเริ่มตั้งแต่วันอาทิตย์ เช่น 2 หมายถึงวันอังคาร
`time`	ต้องระบุ	สตริง	อาจมีเวลาของวันในรูปแบบ hhmm แบบ 24 ชั่วโมง ค่าจะอยู่ในช่วง 0000-2359 ระบบจะรายงานเวลาตามเขตเวลาของสถานที่นั้นๆ
`date`	ไม่บังคับ	สตริง	วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31
`truncated`	ไม่บังคับ	บูลีน	เป็นจริงหากระยะเวลาที่ระบุถูกตัดให้สั้นลงเนื่องจากมีระยะเวลาสิ้นสุด 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

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

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`height`	ต้องระบุ	ตัวเลข	ความสูงของรูปภาพ
`html_attributions`	ต้องระบุ	Array<string>	แอตทริบิวต์ HTML สำหรับรูปภาพ
`photo_reference`	ต้องระบุ	สตริง	สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอรูปภาพ
`width`	ต้องระบุ	ตัวเลข	ความกว้างของรูปภาพ

PlaceReview

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

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`author_name`	ต้องระบุ	สตริง	ชื่อของผู้ใช้ที่ส่งรีวิว รีวิวที่ไม่ระบุตัวตนจะระบุว่าเป็นของ "ผู้ใช้ Google"
`rating`	ต้องระบุ	ตัวเลข	คะแนนโดยรวมของผู้ใช้สำหรับสถานที่นี้ ซึ่งเป็นจำนวนเต็มตั้งแต่ 1 ถึง 5
`relative_time_description`	ต้องระบุ	สตริง	เวลาที่ส่งรีวิวในรูปแบบข้อความ โดยสัมพันธ์กับเวลาปัจจุบัน
`time`	ต้องระบุ	ตัวเลข	เวลาที่ส่งรีวิว โดยวัดเป็นจำนวนวินาทีนับตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 ตามเวลา UTC
`author_url`	ไม่บังคับ	สตริง	URL ของโปรไฟล์ Local Guides ใน Google Maps ของผู้ใช้ (หากมี)
`language`	ไม่บังคับ	สตริง	รหัสภาษา IETF ที่ระบุภาษาของรีวิวที่แสดงผล ช่องนี้มีแท็กภาษาหลักเท่านั้น และไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดจะติดแท็กเป็น "en" ไม่ใช่ "en-AU" หรือ "en-UK" เป็นต้น ช่องนี้จะว่างเปล่าหากมีเพียงคะแนนโดยไม่มีข้อความรีวิว
`original_language`	ไม่บังคับ	สตริง	รหัสภาษา IETF ที่ระบุภาษาต้นฉบับของรีวิว หากรีวิวได้รับการแปลแล้ว `original_language` != `language` ช่องนี้จะมีเฉพาะแท็กภาษาหลักเท่านั้น และไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดจะติดแท็กเป็น "en" ไม่ใช่ "en-AU" หรือ "en-UK" เป็นต้น ช่องนี้จะว่างเปล่าหากมีเพียงคะแนนโดยไม่มีข้อความรีวิว
`profile_photo_url`	ไม่บังคับ	สตริง	URL ของรูปโปรไฟล์ของผู้ใช้ (หากมี)
`text`	ไม่บังคับ	สตริง	รีวิวของผู้ใช้ เมื่อรีวิวสถานที่ด้วย Google Places ระบบจะถือว่ารีวิวแบบข้อความเป็นตัวเลือกที่ไม่บังคับ ดังนั้น ช่องนี้จึงอาจว่างเปล่า โปรดทราบว่าช่องนี้อาจรวมมาร์กอัป HTML พื้นฐาน เช่น การอ้างอิงเอนทิตี `&` อาจแสดงอักขระเครื่องหมายแอมเพอร์แซนด์
`translated`	ไม่บังคับ	บูลีน	ค่าบูลีนที่ระบุว่ารีวิวได้รับการแปลจากภาษาต้นฉบับที่เขียนหรือไม่ หากรีวิวได้รับการแปลซึ่งสอดคล้องกับค่าเป็นจริง Google ขอแนะนำให้คุณระบุข้อมูลนี้แก่ผู้ใช้ เช่น คุณสามารถเพิ่มสตริง "แปลโดย Google" ต่อไปนี้ลงในรีวิวได้

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

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

place_id

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

Fields

ภาษา

ภูมิภาค

reviews_no_translations

reviews_sort

sessiontoken

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

เปลือกหอย

HTTP

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

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

สถานที่

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

date

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`