เมื่อได้ place_id จากการค้นหาสถานที่แล้ว คุณจะ
ขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการหรือ
จุดที่น่าสนใจโดยเริ่มคำขอรายละเอียดสถานที่ (เดิม) ได้ คำขอรายละเอียดสถานที่ (เดิม)
จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ
เช่น ที่อยู่แบบเต็ม หมายเลขโทรศัพท์ การให้คะแนนและรีวิวของผู้ใช้
คำขอรายละเอียดสถานที่ (เดิม)
คำขอรายละเอียดสถานที่ (เดิม) คือ URL ของ HTTP ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/place/details/output?parameters
โดย output อาจมีค่าใดค่าหนึ่งต่อไปนี้
json(แนะนํา) ระบุเอาต์พุตใน JavaScript Object Notation (JSON)xmlระบุเอาต์พุตเป็น XML
ต้องระบุพารามิเตอร์บางอย่างเพื่อเริ่มคำขอค้นหา ตามมาตรฐานใน URL พารามิเตอร์ทั้งหมดจะคั่นด้วยเครื่องหมายแอมเพอร์แซนด์ (&) ด้านล่างนี้คือรายการพารามิเตอร์และค่าที่เป็นไปได้
พารามิเตอร์ที่จำเป็น
-
place_id
ตัวระบุที่เป็นข้อความซึ่งระบุสถานที่ที่ไม่ซ้ำกัน ซึ่งส่งคืนจากการค้นหาสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่
พารามิเตอร์ที่ไม่บังคับ
-
Fields
ข้อควรระวัง: คำขอการค้นหาสถานที่ และคำขอรายละเอียดสถานที่ จะไม่แสดงฟิลด์เดียวกัน คำขอการค้นหาสถานที่จะแสดงผลชุดย่อยของฟิลด์ที่คำขอรายละเอียดสถานที่แสดงผล หากฟิลด์ที่ต้องการไม่ได้ แสดงผลโดยการค้นหาสถานที่ คุณสามารถใช้การค้นหาสถานที่เพื่อรับplace_idจากนั้นใช้รหัสสถานที่ดังกล่าวเพื่อส่งคำขอรายละเอียดสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์ที่ใช้ไม่ได้ในคำขอ Place Search ได้ที่ การรองรับฟิลด์ของ Places APIใช้พารามิเตอร์ฟิลด์เพื่อระบุรายการประเภทข้อมูลสถานที่ที่คั่นด้วยคอมมาเพื่อแสดงผล ตัวอย่างเช่น
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_numberinternational_phone_number,opening_hourssecondary_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 มักจะอัปเดตภาษาที่รองรับอยู่เสมอ ดังนั้นรายการนี้อาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageAPI จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัวAccept-Language - API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีผลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดงผล และลำดับที่แสดงผล Geocoder จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อสำหรับประเภทถนน หรือคำพ้องความหมายที่อาจ ใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น 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 และ Place Details ทั้งหมดภายในเซสชันเป็นของโปรเจ็กต์ 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><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference> <width>4048</width> <height>3036</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference> <width>6016</width> <height>4016</height> <html_attribution><a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference> <width>2048</width> <height>1515</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></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><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></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> |
เมื่อบริการแสดงข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของคำขอ อาจมี |
ในการตอบกลับ JSON ค่าเหล่านี้จะแสดงเป็นองค์ประกอบราก ในคำตอบ XML
องค์ประกอบเหล่านี้จะปรากฏเป็นองค์ประกอบระดับบนสุดใต้ <PlaceDetailsResponse>
PlacesDetailsStatus
รหัสสถานะที่บริการส่งกลับ
OKซึ่งหมายความว่าคำขอ API สำเร็จ-
ZERO_RESULTSซึ่งระบุว่าสถานที่ตั้งที่อ้างอิงplace_idถูกต้อง แต่ไม่ได้อ้างอิงถึงผลลัพธ์ที่ถูกต้องอีกต่อไป ซึ่งอาจเกิดขึ้นหากสถานประกอบการไม่ได้ดำเนินธุรกิจแล้ว -
NOT_FOUNDซึ่งระบุว่าไม่พบสถานที่อ้างอิงplace_idในฐานข้อมูล Places -
INVALID_REQUESTซึ่งบ่งชี้ว่าคำขอ API มีรูปแบบไม่ถูกต้อง -
OVER_QUERY_LIMITที่ระบุข้อมูลต่อไปนี้- คุณส่งคำขอเกินขีดจำกัด QPS
- บัญชีของคุณไม่ได้เปิดใช้การเรียกเก็บเงิน
- ใช้เครดิต $200 รายเดือนหรือโควต้าการใช้งานที่กำหนดเองเกินแล้ว
- วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
-
REQUEST_DENIEDซึ่งระบุว่าคำขอของคุณถูกปฏิเสธ โดยทั่วไปเนื่องจากสาเหตุต่อไปนี้- คำขอไม่มีคีย์ API
- พารามิเตอร์
keyไม่ถูกต้อง
UNKNOWN_ERRORแสดงว่าเกิดข้อผิดพลาดที่ไม่รู้จัก
สถานที่
แอตทริบิวต์ที่อธิบายสถานที่ แอตทริบิวต์บางอย่างอาจไม่พร้อมใช้งานสำหรับสถานที่บางประเภท
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ไม่บังคับ |
Array<AddressComponent>
|
อาร์เรย์ที่มีคอมโพเนนต์แยกต่างหากที่ใช้ได้กับที่อยู่นี้
ดูข้อมูลเพิ่มเติมได้ที่ |
|
ไม่บังคับ | สตริง |
การแสดงที่อยู่ของสถานที่ใน รูปแบบขนาดเล็ก adr |
|
ไม่บังคับ | สตริง |
ระบุสถานะการดำเนินงานของสถานที่ หากเป็นธุรกิจ
หากไม่มีข้อมูลอยู่ ระบบจะไม่แสดง
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
ไม่บังคับ | บูลีน |
ระบุว่าธุรกิจรองรับการรับสินค้าโดยไม่ต้องลงจากรถหรือไม่ |
|
ไม่บังคับ | PlaceOpeningHours |
มีเวลาทำการในอีก 7 วันถัดไป (รวมถึงวันนี้) ระยะเวลาจะเริ่มตั้งแต่เที่ยงคืนของวันที่ส่งคำขอ
และสิ้นสุดเวลา 23:59 น. ในอีก 6 วันต่อมา ฟิลด์นี้ประกอบด้วย
ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours |
|
ไม่บังคับ | บูลีน |
ระบุว่าธุรกิจรองรับการนำส่งหรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าธุรกิจรองรับตัวเลือกที่นั่งในร่มหรือกลางแจ้ง หรือไม่ |
|
ไม่บังคับ | PlaceEditorialSummary |
มีสรุปของสถานที่ ข้อมูลสรุปประกอบด้วยภาพรวมที่เป็นข้อความ และยังมีรหัสภาษาสำหรับภาพรวมเหล่านี้ด้วย (หากมี) ข้อความสรุปต้องแสดงตามที่ระบุไว้และจะ แก้ไขหรือเปลี่ยนแปลงไม่ได้ ดูข้อมูลเพิ่มเติมได้ที่ PlaceEditorialSummary |
|
ไม่บังคับ | สตริง |
สตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้ โดยส่วนใหญ่แล้วที่อยู่นี้จะเทียบเท่ากับที่อยู่ทางไปรษณีย์ โปรดทราบว่า บางประเทศ เช่น สหราชอาณาจักร ไม่อนุญาตให้เผยแพร่ที่อยู่ไปรษณีย์จริงเนื่องจากข้อจำกัดด้านการอนุญาตให้ใช้สิทธิ ที่อยู่ที่จัดรูปแบบแล้วประกอบด้วยคอมโพเนนต์ที่อยู่อย่างน้อย 1 รายการ ตามตรรกะ เช่น ที่อยู่ "111 8th Avenue, New York, NY" ประกอบด้วยคอมโพเนนต์ต่อไปนี้ "111" (หมายเลขถนน), "8th Avenue" (เส้นทาง), "New York" (เมือง) และ "NY" (รัฐในสหรัฐอเมริกา) อย่าแยกวิเคราะห์ที่อยู่ที่จัดรูปแบบแล้วโดยใช้โปรแกรม แต่คุณควรใช้คอมโพเนนต์ของที่อยู่แต่ละรายการ ซึ่งการตอบกลับจาก API จะรวมไว้ด้วยนอกเหนือจากฟิลด์ที่อยู่ที่จัดรูปแบบแล้ว |
|
ไม่บังคับ | สตริง |
มีหมายเลขโทรศัพท์ของสถานที่ใน รูปแบบท้องถิ่น |
|
ไม่บังคับ | Geometry |
มีตำแหน่งและวิวพอร์ตสำหรับตำแหน่ง ดูข้อมูลเพิ่มเติมได้ที่ |
|
ไม่บังคับ | สตริง |
มี URL ของไอคอนที่แนะนำซึ่งอาจแสดงต่อผู้ใช้ เมื่อระบุผลลัพธ์นี้บนแผนที่ |
|
ไม่บังคับ | สตริง |
มีรหัสสี HEX เริ่มต้นสำหรับหมวดหมู่ของสถานที่ |
|
ไม่บังคับ | สตริง |
มี URL ของไอคอนที่แนะนำ โดยไม่รวมนามสกุลประเภทไฟล์ |
|
ไม่บังคับ | สตริง |
มีหมายเลขโทรศัพท์ของสถานที่ในรูปแบบระหว่างประเทศ
รูปแบบระหว่างประเทศจะมีรหัสประเทศและนำหน้าด้วยเครื่องหมายบวก (+) ตัวอย่างเช่น international_phone_number สำหรับ
สำนักงานของ Google ในซิดนีย์ ออสเตรเลีย คือ |
|
ไม่บังคับ | สตริง |
มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สำหรับ |
|
ไม่บังคับ | PlaceOpeningHours |
มีเวลาทำการปกติ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours |
|
ไม่บังคับ | บูลีน |
ใช้ |
|
ไม่บังคับ | Array<PlacePhoto> |
อาร์เรย์ของออบเจ็กต์รูปภาพ ซึ่งแต่ละออบเจ็กต์มีข้อมูลอ้างอิงถึงรูปภาพ คำขออาจแสดงรูปภาพได้สูงสุด 10 รูป ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปภาพสถานที่และวิธีใช้รูปภาพในแอปพลิเคชันได้ในเอกสารประกอบรูปภาพสถานที่ ดูข้อมูลเพิ่มเติมได้ที่ PlacePhoto |
|
ไม่บังคับ | สตริง |
ตัวระบุที่เป็นข้อความซึ่งระบุสถานที่ที่ไม่ซ้ำกัน หากต้องการดึงข้อมูลเกี่ยวกับสถานที่ ให้ส่งตัวระบุนี้ใน
ฟิลด์ |
|
ไม่บังคับ | PlusCode |
การอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูด ซึ่งแสดงถึงพื้นที่: 1/8000 ขององศาโดย 1/8000 ขององศา (ประมาณ 14 ม. x 14 ม. ที่เส้นศูนย์สูตร) หรือเล็กกว่า คุณใช้ Plus Codes แทนที่อยู่ได้ใน สถานที่ที่ไม่มีที่อยู่ (ไม่มีการระบุหมายเลขอ้างอิงอาคารหรือ ไม่มีการตั้งชื่อถนน) ดู Open Location Code และ Plus Code ดูข้อมูลเพิ่มเติมได้ที่ |
|
ไม่บังคับ | ตัวเลข |
ระดับราคาของสถานที่ในระดับ 0 ถึง 4 จำนวนเงินที่แน่นอน ซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค ระดับราคา จะตีความดังนี้
|
|
ไม่บังคับ | ตัวเลข |
มีการให้คะแนนสถานที่ตั้งแต่ 1.0 ถึง 5.0 โดยอิงตามรีวิวของผู้ใช้ที่รวบรวมไว้ |
|
ไม่บังคับ | สตริง | |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่รองรับการจองหรือไม่ |
|
ไม่บังคับ | Array<PlaceReview> |
อาร์เรย์ JSON ของรีวิวสูงสุด 5 รายการ โดยค่าเริ่มต้น ระบบจะจัดเรียงรีวิว
ตามลำดับความเกี่ยวข้อง ใช้พารามิเตอร์คำขอ
Google ขอแนะนำให้ระบุให้ผู้ใช้ทราบว่าผลการค้นหาจัดเรียงตาม
ดูข้อมูลเพิ่มเติมได้ที่ PlaceReview |
|
ไม่บังคับ | สตริง | |
|
ไม่บังคับ | Array<PlaceOpeningHours> |
มีอาร์เรย์ของรายการสำหรับ 7 วันถัดไป ซึ่งรวมถึง
ข้อมูลเกี่ยวกับเวลาทำการรองของธุรกิจ เวลาทำการรองจะ
แตกต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหาร
สามารถระบุเวลาทำการของไดรฟ์ทรูหรือเวลาทำการของบริการนำส่งเป็นเวลาทำการรองได้ ฟิลด์นี้จะป้อนข้อมูลในฟิลด์ย่อย ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่นั้นเสิร์ฟเบียร์หรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่ให้บริการอาหารเช้าหรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่ให้บริการอาหารมื้อสายหรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่ให้บริการอาหารเย็นหรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่ให้บริการอาหารกลางวันหรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่นี้เสิร์ฟอาหารมังสวิรัติหรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่นี้เสิร์ฟไวน์หรือไม่ |
|
ไม่บังคับ | บูลีน |
ระบุว่าธุรกิจรองรับการสั่งกลับบ้านหรือไม่ |
|
ไม่บังคับ | Array<string> |
มีอาร์เรย์ของประเภทฟีเจอร์ที่อธิบายผลลัพธ์ที่ระบุ ดูรายการ ประเภทที่รองรับ |
|
ไม่บังคับ | สตริง |
มี URL ของหน้า Google อย่างเป็นทางการของสถานที่นี้ ซึ่งจะเป็นหน้าของ Google ที่มีข้อมูลที่ดีที่สุดเกี่ยวกับสถานที่นั้นๆ แอปพลิเคชันต้องลิงก์ไปยังหรือฝังหน้านี้ ในหน้าจอที่แสดงผลลัพธ์โดยละเอียดเกี่ยวกับสถานที่แก่ผู้ใช้ |
|
ไม่บังคับ | ตัวเลข |
จำนวนรีวิวทั้งหมดของสถานที่นี้ ไม่ว่าจะมีหรือไม่มีข้อความก็ตาม |
|
ไม่บังคับ | ตัวเลข |
มีจำนวนนาทีที่เขตเวลาปัจจุบันของสถานที่นี้ ออฟเซ็ตจาก UTC เช่น สำหรับสถานที่ในซิดนีย์ ออสเตรเลียในช่วง เวลาออมแสง ค่านี้จะเป็น 660 (+11 ชั่วโมงจาก UTC) และสำหรับ สถานที่ในแคลิฟอร์เนียที่อยู่นอกช่วงเวลาออมแสง ค่านี้จะเป็น -480 (-8 ชั่วโมงจาก UTC) |
|
ไม่บังคับ | สตริง |
สำหรับสถานประกอบการ (
สำหรับผลลัพธ์อื่นๆ ทั้งหมด ฟิลด์ เนื้อหานี้มีไว้ให้อ่านตามที่แสดง อย่าแยกวิเคราะห์ที่อยู่ที่จัดรูปแบบแล้วแบบเป็นโปรแกรม |
|
ไม่บังคับ | สตริง |
เว็บไซต์ที่เชื่อถือได้ของสถานที่นี้ เช่น หน้าแรกของธุรกิจ |
|
ไม่บังคับ | บูลีน |
ระบุว่าสถานที่นั้นมีทางเข้าที่ รองรับเก้าอี้รถเข็นหรือไม่ |
PlaceEditorialSummary
มีสรุปของสถานที่ ข้อมูลสรุปประกอบด้วยภาพรวมที่เป็นข้อความ และยังมีรหัสภาษาสำหรับข้อมูลเหล่านี้ด้วย (หากมี) ข้อความสรุปต้อง แสดงตามที่เป็นอยู่ และจะแก้ไขหรือเปลี่ยนแปลงไม่ได้
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ไม่บังคับ | สตริง |
ภาษาของฟิลด์ก่อนหน้า May not always be present. |
|
ไม่บังคับ | สตริง |
ข้อความสรุปความยาวปานกลางของสถานที่ |
PlaceOpeningHours
ออบเจ็กต์ที่อธิบายเวลาทำการของสถานที่
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ไม่บังคับ | บูลีน |
ค่าบูลีนที่ระบุว่าสถานที่เปิดอยู่หรือไม่ในเวลาปัจจุบัน |
|
ไม่บังคับ | Array<PlaceOpeningHoursPeriod> |
อาร์เรย์ของช่วงเวลาเปิดทำการที่ครอบคลุม 7 วัน โดยเริ่มจาก วันอาทิตย์ตามลำดับเวลา ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriod |
|
ไม่บังคับ | Array<PlaceSpecialDay> |
อาร์เรย์ของรายการสูงสุด 7 รายการที่สอดคล้องกับ 7 วันถัดไป ดูข้อมูลเพิ่มเติมได้ที่ PlaceSpecialDay |
|
ไม่บังคับ | สตริง |
สตริงประเภทที่ใช้ระบุประเภทของเวลาทำการรอง (เช่น |
|
ไม่บังคับ | Array<string> |
อาร์เรย์ของสตริงที่อธิบายเวลาทำการของสถานที่ในรูปแบบข้อความที่มนุษย์อ่านได้ |
PlaceOpeningHoursPeriod
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ต้องระบุ | PlaceOpeningHoursPeriodDetail |
มีออบเจ็กต์วันและเวลา 2 รายการที่อธิบายเวลาที่สถานที่ เปิดทำการ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriodDetail |
|
ไม่บังคับ | PlaceOpeningHoursPeriodDetail |
อาจมีออบเจ็กต์วันและเวลา 1 คู่ที่อธิบายเวลาที่สถานที่
ปิด หากสถานที่เปิดตลอดเวลา ส่วนปิดจะหายไปจากการตอบกลับ
ไคลเอ็นต์สามารถใช้การระบุว่าเปิดตลอดเวลา
เป็นช่วงเวลาที่เปิดซึ่งมีวันที่มีค่า ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriodDetail |
PlaceSpecialDay
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ไม่บังคับ | สตริง |
วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31 |
|
ไม่บังคับ | บูลีน |
จริงหากมีเวลาทำการพิเศษสำหรับวันนี้ หาก
|
PlaceOpeningHoursPeriodDetail
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ต้องระบุ | ตัวเลข |
ตัวเลขตั้งแต่ 0-6 ซึ่งสอดคล้องกับวันในสัปดาห์ โดยเริ่ม ในวันอาทิตย์ เช่น 2 หมายถึงวันอังคาร |
|
ต้องระบุ | สตริง |
อาจมีเวลาของวันในรูปแบบ hhmm แบบ 24 ชั่วโมง ค่าอยู่ในช่วง 0000–2359 ระบบจะรายงานเวลาในเขตเวลาของสถานที่ |
|
ไม่บังคับ | สตริง |
วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31 |
|
ไม่บังคับ | บูลีน |
เป็นจริงหากมีการตัดช่วงเวลาที่ระบุเนื่องจากกำหนดเวลา 7 วัน โดยช่วงเวลาเริ่มต้นก่อนเที่ยงคืนในวันที่ส่งคำขอ และ/หรือสิ้นสุดตั้งแต่เที่ยงคืนเป็นต้นไปในวันสุดท้าย พร็อพเพอร์ตี้นี้ บ่งบอกว่าระยะเวลาเปิดหรือปิดอาจขยายออกไปหลังจาก กำหนดเวลา 7 วันนี้ |
PlacePhoto
รูปภาพของสถานที่ คุณเข้าถึงรูปภาพได้โดยใช้ API Place Photo โดยใช้ URL ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
ดูข้อมูลเพิ่มเติมได้ที่ รูปภาพสถานที่
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ต้องระบุ | ตัวเลข |
ความสูงของรูปภาพ |
|
ต้องระบุ | Array<string> |
การระบุแหล่งที่มาของ HTML สำหรับรูปภาพ |
|
ต้องระบุ | สตริง |
สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอ Photo |
|
ต้องระบุ | ตัวเลข |
ความกว้างของรูปภาพ |
PlaceReview
รีวิวสถานที่ที่ผู้ใช้ส่ง
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ต้องระบุ | สตริง |
ชื่อของผู้ใช้ที่ส่งรีวิว รีวิวที่ไม่ระบุชื่อจะ ระบุแหล่งที่มาเป็น "ผู้ใช้ Google" |
|
ต้องระบุ | ตัวเลข |
คะแนนโดยรวมของผู้ใช้สำหรับสถานที่นี้ ซึ่งเป็นเลขจำนวนเต็ม ตั้งแต่ 1 ถึง 5 |
|
ต้องระบุ | สตริง |
เวลาที่ส่งรีวิวเป็นข้อความ โดยอิงตามเวลาปัจจุบัน |
|
ต้องระบุ | ตัวเลข |
เวลาที่ส่งรีวิว โดยวัดเป็นจำนวน วินาทีนับตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 UTC |
|
ไม่บังคับ | สตริง |
URL ของโปรไฟล์ Local Guide ใน Google Maps ของผู้ใช้ หากมี |
|
ไม่บังคับ | สตริง |
รหัสภาษา IETF ที่ระบุภาษาของรีวิวที่แสดงผล ช่องนี้มีเฉพาะแท็กภาษาหลักเท่านั้น ไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดจะติดแท็กเป็น 'en' ไม่ใช่ 'en-AU' หรือ 'en-UK' และอื่นๆ ฟิลด์นี้จะว่างเปล่าหากมีเฉพาะคะแนนที่ไม่มีข้อความรีวิว |
|
ไม่บังคับ | สตริง |
รหัสภาษา IETF ที่ระบุภาษาต้นฉบับของรีวิว หากรีวิวได้รับการแปลแล้ว |
|
ไม่บังคับ | สตริง |
URL ไปยังรูปโปรไฟล์ของผู้ใช้ (หากมี) |
|
ไม่บังคับ | สตริง |
รีวิวของผู้ใช้ เมื่อรีวิวสถานที่ด้วย Google Places
ระบบจะถือว่ารีวิวที่เป็นข้อความเป็นตัวเลือก ดังนั้น ช่องนี้อาจ
ว่างเปล่า โปรดทราบว่าฟิลด์นี้อาจมีมาร์กอัป HTML พื้นฐาน ตัวอย่างเช่น การอ้างอิงเอนทิตี |
|
ไม่บังคับ | บูลีน |
ค่าบูลีนที่ระบุว่ารีวิวได้รับการแปลจากภาษาต้นฉบับที่เขียนหรือไม่ หากรีวิวได้รับการแปลซึ่งสอดคล้องกับค่าเป็นจริง Google ขอแนะนำให้คุณระบุข้อมูลนี้ต่อผู้ใช้ เช่น คุณสามารถเพิ่มสตริง "แปลโดย Google" ลงในรีวิวได้ |