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

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

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

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

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

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

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

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

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

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

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

  • Fields

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

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

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

    พื้นฐาน

    หมวดหมู่พื้นฐานประกอบด้วยฟิลด์ต่อไปนี้ 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 เป็นคำพ้องความหมายของถนนในภาษาฮังการี
  • ภูมิภาค

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

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

  • sessiontoken

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

    เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์คำค้นหา และสิ้นสุดเมื่อ ผู้ใช้เลือกสถานที่และมีการเรียกไปยังรายละเอียดสถานที่ (เดิม) แต่ละเซสชันสามารถ มีการค้นหาหลายรายการ ตามด้วยการเลือกสถานที่ 1 แห่ง คีย์ API ที่ใช้สำหรับคำขอแต่ละรายการภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ได้ระบุพารามิเตอร์ 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,
          },
          {
            "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

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

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

ต้องระบุ สถานที่

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

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

ต้องระบุ 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 ของไอคอนที่แนะนำซึ่งอาจแสดงต่อผู้ใช้เมื่อระบุผลการค้นหานี้บนแผนที่

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

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

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

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

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

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

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

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

ไม่บังคับ PlaceOpeningHours

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

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

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

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

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

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

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

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

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

ไม่บังคับ PlusCode

การอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูด ซึ่งแสดงถึงพื้นที่: 1/8000 ขององศาโดย 1/8000 ขององศา (ประมาณ 14 ม. x 14 ม. ที่เส้นศูนย์สูตร) หรือเล็กกว่า คุณใช้โค้ด Plus แทนที่อยู่ได้ใน สถานที่ที่ไม่มีที่อยู่ (ไม่มีหมายเลขอ้างอิงอาคารหรือ ไม่มีชื่อถนน) ดู Open Location Code และ 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

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

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

ไม่บังคับ PlaceOpeningHoursPeriodDetail

อาจมีออบเจ็กต์วันและเวลา 1 คู่ที่อธิบายเวลาที่สถานที่ ปิด หากสถานที่เปิดอยู่เสมอ จะไม่มีส่วนปิด ในการตอบกลับ ไคลเอ็นต์สามารถใช้การแสดงผล "เปิดตลอดเวลา" เป็นช่วงเวลาเปิดที่มีวันที่มีค่า 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 หมายถึงวันอังคาร

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

อาจมีเวลาในรูปแบบ 24 ชั่วโมง hhmm ค่าอยู่ในช่วง 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" ลงในรีวิวได้