การค้นหาในบริเวณใกล้เคียง (เดิม) ช่วยให้คุณค้นหาสถานที่ภายในพื้นที่ที่ระบุได้ คุณสามารถ ปรับแต่งคำขอค้นหาได้โดยระบุคีย์เวิร์ดหรือประเภท สถานที่ที่ต้องการค้นหา
คำขอการค้นหาในบริเวณใกล้เคียง (เดิม)
คำขอการค้นหาในบริเวณใกล้เคียง (เดิม) คือ HTTP URL ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters
โดย output อาจมีค่าใดค่าหนึ่งต่อไปนี้
json(แนะนํา) ระบุเอาต์พุตใน JavaScript Object Notation (JSON)xmlระบุเอาต์พุตเป็น XML
ต้องระบุพารามิเตอร์บางอย่างเพื่อเริ่มคำขอการค้นหาในบริเวณใกล้เคียง (เดิม) พารามิเตอร์ทั้งหมดจะคั่นด้วยเครื่องหมายแอมเพอร์แซนด์ (&) ตาม
มาตรฐานใน URL
พารามิเตอร์ที่จำเป็น
-
สถานที่
จุดที่ใช้ดึงข้อมูลสถานที่ ต้องระบุเป็น
latitude,longitude -
รัศมี
กำหนดระยะทาง (เป็นเมตร) ที่จะแสดงผลลัพธ์ของสถานที่ คุณ อาจทำให้ผลลัพธ์เอนเอียงไปยังวงกลมที่ระบุได้โดยส่งพารามิเตอร์
locationและradiusการทำเช่นนี้จะสั่งให้บริการ Places แสดงผลลัพธ์ภายในวงกลมนั้นต่อไป ผลลัพธ์ที่อยู่นอกพื้นที่ที่กำหนดอาจยังคงแสดงอยู่ระบบจะจำกัดรัศมีโดยอัตโนมัติให้มีค่าสูงสุดตามประเภทการค้นหาและพารามิเตอร์อื่นๆ
- เติมข้อความอัตโนมัติ: 50,000 เมตร
-
การค้นหาในบริเวณใกล้เคียง
- ด้วย
keywordหรือname: 50,000 เมตร -
ไม่มี
keywordหรือname-
สูงสุด 50,000 เมตร ปรับแบบไดนามิกตามความหนาแน่นของพื้นที่
โดยไม่ขึ้นอยู่กับพารามิเตอร์
rankby -
เมื่อใช้
rankby=distanceระบบจะไม่ยอมรับพารามิเตอร์รัศมี และจะส่งผลให้เกิดINVALID_REQUEST
-
สูงสุด 50,000 เมตร ปรับแบบไดนามิกตามความหนาแน่นของพื้นที่
โดยไม่ขึ้นอยู่กับพารามิเตอร์
- ด้วย
- การเติมคำค้นหาอัตโนมัติ: 50,000 เมตร
- การค้นหาข้อความ: 50,000 เมตร
พารามิเตอร์ที่ไม่บังคับ
-
คีย์เวิร์ด
สตริงข้อความที่จะค้นหา เช่น "ร้านอาหาร" หรือ "123 ถนนเมน" ต้องเป็นชื่อสถานที่ ที่อยู่ หรือหมวดหมู่ของ สถานประกอบการ อินพุตประเภทอื่นๆ อาจทำให้เกิดข้อผิดพลาดและไม่รับประกันว่าจะแสดงผลลัพธ์ที่ถูกต้อง บริการ Google Places จะแสดงรายการที่ตรงกัน ตามสตริงนี้และจัดลำดับผลการค้นหาตาม ความเกี่ยวข้องที่ระบบรับรู้
การระบุข้อมูลสถานที่อย่างชัดเจนโดยใช้พารามิเตอร์นี้อาจ ขัดแย้งกับพารามิเตอร์ location, radius และ rankby ซึ่งทําให้เกิด ผลลัพธ์ที่ไม่คาดคิด
หากไม่ระบุพารามิเตอร์นี้ ระบบจะไม่แสดงสถานที่ที่มี business_status เป็น CLOSED_TEMPORARILY หรือ CLOSED_PERMANENTLY
-
ภาษา
ภาษาที่จะแสดงผลลัพธ์
- ดู รายการภาษาที่รองรับ Google มักจะอัปเดตภาษาที่รองรับอยู่เสมอ ดังนั้นรายการนี้อาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageAPI จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัวAccept-Language - API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีผลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดงผล และลำดับที่แสดงผล Geocoder จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อสำหรับประเภทถนน หรือคำพ้องความหมายที่อาจ ใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของถนนในภาษาฮังการี
-
maxprice
จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่อยู่ในช่วงที่ระบุ ค่าที่ใช้ได้ อยู่ระหว่าง 0 (ราคาถูกที่สุด) ถึง 4 (แพงที่สุด) จำนวนเงินที่แน่นอนซึ่งระบุโดยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค
-
minprice
จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่อยู่ในช่วงที่ระบุ ค่าที่ใช้ได้ อยู่ระหว่าง 0 (ราคาถูกที่สุด) ถึง 4 (แพงที่สุด) จำนวนเงินที่แน่นอนซึ่งระบุโดยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค
-
ชื่อ
เทียบเท่ากับ
keywordระบบจะรวมค่าในช่องนี้กับค่าในช่องkeywordและส่งเป็นส่วนหนึ่งของสตริงการค้นหาเดียวกัน -
opennow
แสดงเฉพาะสถานที่ที่เปิดให้บริการในขณะที่ส่งคำค้นหา เท่านั้น สถานที่ที่ไม่ได้ระบุเวลาทำการในฐานข้อมูล Google Places จะไม่แสดงหากคุณรวมพารามิเตอร์นี้ไว้ในการค้นหา
-
pagetoken
แสดงผลการค้นหาได้สูงสุด 20 รายการจากการค้นหาที่เรียกใช้ก่อนหน้านี้ การตั้งค่าพารามิเตอร์
pagetokenจะทําให้ระบบทําการค้นหาด้วยพารามิเตอร์เดียวกันกับที่ใช้ก่อนหน้านี้ โดยระบบจะไม่สนใจพารามิเตอร์อื่นๆ ทั้งหมดนอกเหนือจาก pagetoken -
rankby
ระบุลำดับที่แสดงผลลัพธ์ ค่าที่เป็นไปได้มีดังนี้
-
prominence(ค่าเริ่มต้น) ตัวเลือกนี้จะจัดเรียงผลลัพธ์ตาม ความสำคัญ การจัดอันดับจะให้ความสำคัญกับสถานที่ที่โดดเด่นภายในรัศมีที่กำหนดมากกว่าสถานที่ใกล้เคียงที่ตรงกันแต่มีความโดดเด่นน้อยกว่า ความโดดเด่นอาจได้รับผลกระทบจากอันดับของสถานที่ในดัชนีของ Google ความนิยมทั่วโลก และปัจจัยอื่นๆ เมื่อระบุความโดดเด่นแล้ว จะต้องระบุพารามิเตอร์radius -
distanceตัวเลือกนี้จะให้ความสำคัญกับผลการค้นหาตามลำดับจากใกล้ไปไกลจากตำแหน่งที่ระบุ เมื่อระบุdistanceจะต้องระบุkeyword,nameหรือtypeอย่างน้อย 1 รายการ และไม่อนุญาตให้ระบุradius
-
-
ประเภท
จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุ ระบุได้เพียงประเภทเดียว เท่านั้น หากระบุประเภทมากกว่า 1 ประเภท ระบบจะไม่สนใจประเภททั้งหมดที่ตามมา หลังจากรายการแรก
-
type=hospital|pharmacy|doctorเปลี่ยนเป็นtype=hospital - ระบบจะไม่สนใจ
type=hospital,pharmacy,doctorโดยสิ้นเชิง
ดูรายการ ประเภทที่รองรับ
หมายเหตุ: การเพิ่มทั้งkeywordและtypeที่มีค่าเดียวกัน (keyword=cafe&type=cafeหรือkeyword=parking&type=parking) อาจทำให้ได้ZERO_RESULTS -
ตัวอย่างการค้นหาในบริเวณใกล้เคียง (เดิม)
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/nearbysearch/json ?keyword=cruise &location=-33.8670522%2C151.1957362 &radius=1500 &type=restaurant &key=YOUR_API_KEY
หมายเหตุ: ในตัวอย่างนี้ คุณต้องแทนที่ key
ด้วยคีย์ API ของคุณเองเพื่อให้คำขอทำงานในแอปพลิเคชันได้
การตอบกลับการค้นหาในบริเวณใกล้เคียง (เดิม)
ตัวอย่างต่อไปนี้แสดงการตอบกลับของการค้นหาในบริเวณใกล้เคียง (เดิม)
JSON
{ "html_attributions": [], "results": [ { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8587323, "lng": 151.2100055 }, "viewport": { "northeast": { "lat": -33.85739847010727, "lng": 151.2112436298927 }, "southwest": { "lat": -33.86009812989271, "lng": 151.2085439701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png", "icon_background_color": "#FF9E67", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet", "name": "Cruise Bar", "opening_hours": { "open_now": false }, "photos": [ { "height": 608, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG", "width": 1080, }, ], "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI", "plus_code": { "compound_code": "46R6+G2 The Rocks, New South Wales", "global_code": "4RRH46R6+G2", }, "price_level": 2, "rating": 4, "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI", "scope": "GOOGLE", "types": ["bar", "restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 1269, "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8675219, "lng": 151.2016502 }, "viewport": { "northeast": { "lat": -33.86614532010728, "lng": 151.2031259298927 }, "southwest": { "lat": -33.86884497989272, "lng": 151.2004262701072 }, }, }, "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", "name": "Sydney Harbour Dinner Cruises", "opening_hours": { "open_now": true }, "photos": [ { "height": 835, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7", "width": 1200, }, ], "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids", "plus_code": { "compound_code": "46J2+XM Sydney, New South Wales", "global_code": "4RRH46J2+XM", }, "rating": 4.8, "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids", "scope": "GOOGLE", "types": [ "tourist_attraction", "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 9, "vicinity": "32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8676569, "lng": 151.2017213 }, "viewport": { "northeast": { "lat": -33.86629922010728, "lng": 151.2031712798927 }, "southwest": { "lat": -33.86899887989272, "lng": 151.2004716201073 }, }, }, "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", "name": "Clearview Sydney Harbour Cruises", "opening_hours": { "open_now": false }, "photos": [ { "height": 685, "html_attributions": [ 'Clearview Glass Boat Cruises', ], "photo_reference": "Aap_uEAlExjnXA0VWyb_oYwCJ8utWG_Ennhwmn_xadpgenMNUgTuxrvgf1Xdw4bsbL6kFSWH7bhbpVHK1esdNY37ancJvbL_Gnsc7EZ5KEBNPvYZ_ZEyLco4a5v34LFkodxfFZbJ-ejO3zN4W_0C37P5jAmTnLWMNFYUPvoU3UMi70qHRNF5", "width": 1024, }, ], "place_id": "ChIJNQfwZTiuEmsR1m1x9w0E2V0", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 3.8, "reference": "ChIJNQfwZTiuEmsR1m1x9w0E2V0", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 49, "vicinity": "32 The Promenade King Street Wharf 5, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8677035, "lng": 151.2017297 }, "viewport": { "northeast": { "lat": -33.86634597010728, "lng": 151.2031781298927 }, "southwest": { "lat": -33.86904562989272, "lng": 151.2004784701072 }, }, }, "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", "name": "Sydney Harbour Lunch Cruise", "opening_hours": { "open_now": false }, "photos": [ { "height": 545, "html_attributions": [ 'Sydney Harbour Lunch Cruise', ], "photo_reference": "Aap_uEBFyQ2xDzHk7dGF_FTvNeJ01NQD6GROq89rufdGQl5Gi0zVfpnETBjPK2v7UEDl_6F-m8aR5FcEWJMqPaH4Oh_CQh2jaUAUAesUInucpCe7OFdleSYJ_8kgunhsIvGf1D1s_pes6Rk2JMVEs8rEs6ZHSTmUQXX2Yh-Gt9MuPQdYNuNv", "width": 969, }, ], "place_id": "ChIJUbf3iDiuEmsROJxXbhYO7cM", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 3.9, "reference": "ChIJUbf3iDiuEmsROJxXbhYO7cM", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 23, "vicinity": "5/32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8675883, "lng": 151.2016452 }, "viewport": { "northeast": { "lat": -33.86623847010728, "lng": 151.2029950298927 }, "southwest": { "lat": -33.86893812989273, "lng": 151.2002953701073 }, }, }, "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", "name": "Sydney Showboats - Dinner Cruise With Show", "opening_hours": { "open_now": false }, "photos": [ { "height": 4912, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uED1aGaMs8xYfiuzeBqVcFsk3yguUujdE4S3rNThMpLtoU0RukF40KCt0CAxgHP1HoY8Z7NYcWvax6qmMMVPBbmzGhoaiwiAAyv2GGA9vhcgsJ5w0LweT0y1lgRGZxU3nZIdNLiYAp9JHM171UkN04H6UqYSxKVZ8N_f2aslkqOaBF_e", "width": 7360, }, ], "place_id": "ChIJjRuIiTiuEmsRCHhYnrWiSok", "plus_code": { "compound_code": "46J2+XM Sydney, New South Wales", "global_code": "4RRH46J2+XM", }, "rating": 4.1, "reference": "ChIJjRuIiTiuEmsRCHhYnrWiSok", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 119, "vicinity": "32 The Promenade, King Street Wharf, 5, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8677035, "lng": 151.2017297 }, "viewport": { "northeast": { "lat": -33.86634597010728, "lng": 151.2031781298927 }, "southwest": { "lat": -33.86904562989272, "lng": 151.2004784701072 }, }, }, "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", "name": "Magistic Cruises", "opening_hours": { "open_now": true }, "photos": [ { "height": 1536, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEC8bq-YphfIDcdxANBfgGMBIX2B0ggNep9ddVoePj6sfdcdusIn07x8biaxevZ_6BpzDDRsUL8No5P3ftI4on_pqbAbIEUL5gFGgezpVZ3M9GWvKdJm3njO_aJaghWl4_aQb75c0WGYDRFPhn6fWsLkD7KxodviJeCX4OCGt1eRJnlK", "width": 2048, }, ], "place_id": "ChIJxRjqYTiuEmsRGebAA_chDLE", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 3.9, "reference": "ChIJxRjqYTiuEmsRGebAA_chDLE", "scope": "GOOGLE", "types": [ "tourist_attraction", "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 99, "vicinity": "King Street Wharf, 32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8609391, "lng": 151.2098735 }, "viewport": { "northeast": { "lat": -33.85958927010727, "lng": 151.2112233298927 }, "southwest": { "lat": -33.86228892989272, "lng": 151.2085236701072 }, }, }, "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", "name": "Australian Cruise Group", "opening_hours": { "open_now": false }, "photos": [ { "height": 1536, "html_attributions": [ 'Keith Bauman', ], "photo_reference": "Aap_uED7aBwIbN6iuoZi8e9xCrt6F_EhppGCBfzYCgypetw8cGn4Ui0Y3JZe3QJ0buf0zc54BtPz-SWXxecPd6kDvNNZD5Eu_ZzTP13rXMzSDJa6UcwFiXU4y3qYrWAyJ6mtYrd2PJgw0KzvYaZoPze7Ka6zG6k3IOjeSICDYH6YOzkXhelj", "width": 2048, }, ], "place_id": "ChIJpU8KgUKuEmsRKErVGEaa11w", "plus_code": { "compound_code": "46Q5+JW Sydney, New South Wales", "global_code": "4RRH46Q5+JW", }, "rating": 4.4, "reference": "ChIJpU8KgUKuEmsRKErVGEaa11w", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 5, "vicinity": "6 Cirular Quay, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8686058, "lng": 151.2018206 }, "viewport": { "northeast": { "lat": -33.86730002010728, "lng": 151.2032717798927 }, "southwest": { "lat": -33.86999967989272, "lng": 151.2005721201073 }, }, }, "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", "name": "Rhythmboat Cruises", "opening_hours": { "open_now": false }, "photos": [ { "height": 2269, "html_attributions": [ 'Rhythmboat Sydney Harbour Cruises', ], "photo_reference": "Aap_uEAT8eop-IsfSAQ3KP6YXRNRsFkESXDecsaPnaVhq5bZzny5guvhS4smciianRGbZgDtFtAcU-ZXTaBfuh80CFw8vpJyKaB4grgW_CW64rU1JF9FDy_M8HtEk3rOrMhPDiF8ns-mc16E4rWSuAQIc76Du_eCd63ofoErESOtSWAQVcew", "width": 4032, }, ], "place_id": "ChIJyWEHuEmuEmsRm9hTkapTCrk", "plus_code": { "compound_code": "46J2+HP Sydney, New South Wales", "global_code": "4RRH46J2+HP", }, "rating": 3.9, "reference": "ChIJyWEHuEmuEmsRm9hTkapTCrk", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 30, "vicinity": "King Street Wharf, King St, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8712692, "lng": 151.1898651 }, "viewport": { "northeast": { "lat": -33.86952792010727, "lng": 151.1914560298927 }, "southwest": { "lat": -33.87222757989272, "lng": 151.1887563701073 }, }, }, "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", "name": "Glass Island", "opening_hours": { "open_now": false }, "photos": [ { "height": 4480, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEAaToCBaHP7Gfdjc740gwIkQcjeUD97NO0TKXJ5IXB0CLGQA6slEpHn4k9LwyhoAzzbSTXJduYyFIkHVmQWGp34NggRxrtOWp7sJf5N6j0ASYlJPmAtWUaaCWnbx_pxdndsopeJ7PYn9kTiMgFcSs-GeipI8hDZgAJswMBnfsO0xWQ-", "width": 6720, }, ], "place_id": "ChIJnScuboavEmsRyh-FGxhc3pw", "plus_code": { "compound_code": "45HQ+FW Pyrmont, New South Wales", "global_code": "4RRH45HQ+FW", }, "rating": 4.1, "reference": "ChIJnScuboavEmsRyh-FGxhc3pw", "scope": "GOOGLE", "types": ["bar", "restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 90, "vicinity": "37 Bank St, Pyrmont", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.85876140000001, "lng": 151.2100004 }, "viewport": { "northeast": { "lat": -33.85737742010728, "lng": 151.2111319298927 }, "southwest": { "lat": -33.86007707989272, "lng": 151.2084322701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png", "icon_background_color": "#FF9E67", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet", "name": "Junk Lounge", "opening_hours": { "open_now": false }, "photos": [ { "height": 608, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEDaHF9VZFV88tQqFyIgmPlcbCsK-ScCGuUVGh0mTAP4OzWh_0q0T5rPbeC7bas7vD5vC9oS95jtdr4oOnQmhGDAIbHkv4E6UHrQIl0f3XZ-3-RRDjn293w4qQb_BfhbPPO3nokU7npfMfVvCcelWf9WHiWNHT4EEHrFtvuhAWKobTnC", "width": 1080, }, ], "place_id": "ChIJq9W3HZOvEmsRYtKNTRmq34M", "plus_code": { "compound_code": "46R6+F2 The Rocks, New South Wales", "global_code": "4RRH46R6+F2", }, "price_level": 2, "rating": 4.1, "reference": "ChIJq9W3HZOvEmsRYtKNTRmq34M", "scope": "GOOGLE", "types": ["restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 63, "vicinity": "Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8677035, "lng": 151.2017297 }, "viewport": { "northeast": { "lat": -33.86634597010728, "lng": 151.2031781298927 }, "southwest": { "lat": -33.86904562989272, "lng": 151.2004784701072 }, }, }, "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", "name": "Sydney New Year's Eve Cruises", "opening_hours": { "open_now": true }, "photos": [ { "height": 1600, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEDceKHtQ9Hf2eHwnQYXLqrwZ1X2LYVhsfXbqrpIm3_lXZ9apURjAXtVgRVTGxJPD7BtaqR8C7bwaSTakmi0Pazn7g3suj8ZaQRBqheT3KVJDhZ9_GwVInLkWbxqnhivEXs1a-MC_J8XF1SL_5AQ3mAETgiLRQ04116IAEV5vHyIGRsa", "width": 2400, }, ], "place_id": "ChIJ__8_hziuEmsR27ucFXECfOg", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 5, "reference": "ChIJ__8_hziuEmsR27ucFXECfOg", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 5, "vicinity": "King Street Wharf 5, 32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8669866, "lng": 151.2017231 }, "viewport": { "northeast": { "lat": -33.86563197010727, "lng": 151.2031347298927 }, "southwest": { "lat": -33.86833162989272, "lng": 151.2004350701073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#13B5C7", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "King Street Wharf Darling Harbour", "opening_hours": { "open_now": true }, "photos": [ { "height": 3024, "html_attributions": [ '朱品貞', ], "photo_reference": "Aap_uEDwKXVOjIaCj3LptOdd86B5umsdG7Z3jcvqcpUVLwHS6w8VGEkphgC8-shAx95CrsuXpnKz-XVIixVmgagQHKPH3vSLLqJ6LOAR7Q-_jiyx3ELXD0pm7AARiAtQAMBN9A-oqbtvGbE27yDpvBS1lKe9PCm-dMfrHIIcsS91Qeq2E4b6", "width": 4032, }, ], "place_id": "ChIJkfDzJ72vEmsR8xtYbk5f0p0", "plus_code": { "compound_code": "46M2+6M Sydney, New South Wales", "global_code": "4RRH46M2+6M", }, "rating": 4.4, "reference": "ChIJkfDzJ72vEmsR8xtYbk5f0p0", "scope": "GOOGLE", "types": [ "tourist_attraction", "convenience_store", "bowling_alley", "travel_agency", "bar", "restaurant", "food", "point_of_interest", "store", "establishment", ], "user_ratings_total": 3213, "vicinity": "The Promenade, Lime St, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.870383, "lng": 151.1979245 }, "viewport": { "northeast": { "lat": -33.86901092010727, "lng": 151.1991702798927 }, "southwest": { "lat": -33.87171057989271, "lng": 151.1964706201073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png", "icon_background_color": "#FF9E67", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet", "name": "The Little Snail Restaurant", "opening_hours": { "open_now": false }, "photos": [ { "height": 900, "html_attributions": [ 'The Little Snail', ], "photo_reference": "Aap_uEA9aHKkB_6VoFx4VHRSp19PCwnTOuGfpmDYw1NdYNbzncfdjjfEmiiFz-E4tIJ6iGVZjR_bejX6wNr5thJjqlcdQ2PvPyTTo1jGtxk31JG9b6Vd0vu_v4Ep7yutzf3KTzBjYFBIGsYPf3Pj0DptMWPLP7fn33SBT7YmRqDEoGcUsBzw", "width": 1350, }, ], "place_id": "ChIJtwapWjeuEmsRcxV5JARHpSk", "plus_code": { "compound_code": "45HX+R5 Pyrmont, New South Wales", "global_code": "4RRH45HX+R5", }, "price_level": 2, "rating": 4.5, "reference": "ChIJtwapWjeuEmsRcxV5JARHpSk", "scope": "GOOGLE", "types": ["restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 1916, "vicinity": "3/50 Murray St, Pyrmont", }, ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceSearchResponse> <status>OK</status> <result> <name>Cruise Bar</name> <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity> <type>bar</type> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8587323</lat> <lng>151.2100055</lng> </location> <viewport> <southwest> <lat>-33.8600981</lat> <lng>151.2085440</lng> </southwest> <northeast> <lat>-33.8573985</lat> <lng>151.2112436</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon> <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference> <width>1080</width> <height>608</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112582655193348962755">A Google User</a></html_attribution> </photo> <price_level>2</price_level> <user_ratings_total>1269</user_ratings_total> <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46R6+G2</global_code> <compound_code>46R6+G2 The Rocks, New South Wales</compound_code> </plus_code> <icon_background_color>#FF9E67</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet</icon_mask_base_uri> </result> <result> <name>Sydney Harbour Dinner Cruises</name> <vicinity>32 The Promenade, Sydney</vicinity> <type>tourist_attraction</type> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8675219</lat> <lng>151.2016502</lng> </location> <viewport> <southwest> <lat>-33.8688450</lat> <lng>151.2004263</lng> </southwest> <northeast> <lat>-33.8661453</lat> <lng>151.2031259</lng> </northeast> </viewport> </geometry> <rating>4.8</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference> <width>1200</width> <height>835</height> <html_attribution><a href="https://maps.google.com/maps/contrib/109764923610545394994">A Google User</a></html_attribution> </photo> <user_ratings_total>9</user_ratings_total> <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+XM</global_code> <compound_code>46J2+XM Sydney, New South Wales</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> <result> <name>Clearview Sydney Harbour Cruises</name> <vicinity>32 The Promenade King Street Wharf 5, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8676569</lat> <lng>151.2017213</lng> </location> <viewport> <southwest> <lat>-33.8689989</lat> <lng>151.2004716</lng> </southwest> <northeast> <lat>-33.8662992</lat> <lng>151.2031713</lng> </northeast> </viewport> </geometry> <rating>3.8</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJNQfwZTiuEmsR1m1x9w0E2V0</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uED7hBZqIUaBgFu5q8_xoLMrkWIXUau5D7J2T2fS3HAk4j3aoOp5MQKiujaS8ByzfU9zshp37EMMW6tZe67qLYku2AW-QOVeTbJlyxQ7bqgtSZ_YTo_ES1Xw1bBx8wv8BJYTJZFRzh8enBdH0kLy-oICBpm2fDexARp4CG8Dsxz5bqGA</photo_reference> <width>1024</width> <height>685</height> <html_attribution><a href="https://maps.google.com/maps/contrib/114394575270272775071">Clearview Glass Boat Cruises</a></html_attribution> </photo> <user_ratings_total>49</user_ratings_total> <place_id>ChIJNQfwZTiuEmsR1m1x9w0E2V0</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</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> <result> <name>Sydney Harbour Lunch Cruise</name> <vicinity>5/32 The Promenade, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8677035</lat> <lng>151.2017297</lng> </location> <viewport> <southwest> <lat>-33.8690456</lat> <lng>151.2004785</lng> </southwest> <northeast> <lat>-33.8663460</lat> <lng>151.2031781</lng> </northeast> </viewport> </geometry> <rating>3.9</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJUbf3iDiuEmsROJxXbhYO7cM</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uED1kwFA2W4XWHpSNZBxiE10JfyZEJrOz8aAPXpR2GbOg0Pc-yPHJYjt6m007fRdSG2PzvsWdZIFE-lny_NRBGUrSzpk9eNVzDp3GLUeV9G0HXcQv7IhEK6vtm_Updlv66bi8S07h3e_lFiHIzFw0TLVfWXjc63Pm94NN1kug7RPJa-6</photo_reference> <width>969</width> <height>545</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102428257696490257922">Sydney Harbour Lunch Cruise</a></html_attribution> </photo> <user_ratings_total>23</user_ratings_total> <place_id>ChIJUbf3iDiuEmsROJxXbhYO7cM</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</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> <result> <name>Sydney Showboats - Dinner Cruise With Show</name> <vicinity>32 The Promenade, King Street Wharf, 5, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8675883</lat> <lng>151.2016452</lng> </location> <viewport> <southwest> <lat>-33.8689381</lat> <lng>151.2002954</lng> </southwest> <northeast> <lat>-33.8662385</lat> <lng>151.2029950</lng> </northeast> </viewport> </geometry> <rating>4.1</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJjRuIiTiuEmsRCHhYnrWiSok</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEAGYIvNdkpJvsbVLPNaMlKukR9jvX48rKMo_TPqbSBRYqvYGExwQM8YvHrz83U7UOJosNI0kay5wV9vZdr9fR12ElFlK5fY3xdoS9N9T08ejq2gLABJJK-Bwl4W2IPw9imoWef1BYMVP07WhXhVOs05a-2A3Qm5fKCRILgUis5pMeCg</photo_reference> <width>7360</width> <height>4912</height> <html_attribution><a href="https://maps.google.com/maps/contrib/105311284660389698992">A Google User</a></html_attribution> </photo> <user_ratings_total>119</user_ratings_total> <place_id>ChIJjRuIiTiuEmsRCHhYnrWiSok</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+XM</global_code> <compound_code>46J2+XM Sydney, New South Wales</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> <result> <name>Magistic Cruises</name> <vicinity>King Street Wharf, 32 The Promenade, Sydney</vicinity> <type>tourist_attraction</type> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8677035</lat> <lng>151.2017297</lng> </location> <viewport> <southwest> <lat>-33.8690456</lat> <lng>151.2004785</lng> </southwest> <northeast> <lat>-33.8663460</lat> <lng>151.2031781</lng> </northeast> </viewport> </geometry> <rating>3.9</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJxRjqYTiuEmsRGebAA_chDLE</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEDbALKhgsD-bIG6fWxrermkmKtpIKDHthAySc9EjPEpWDQQtYsSgB4AqLVMArTFCWd04Vb9U51st96ONjtDmWf8KsjKwYtkWxYDFzaY9ZmO2UQpV3rnqjmNHXtIsCdjjwADQbumAkjn5WzBJ-DqlVZs9NmlpLvAY6Jg4DGhduWdewv4</photo_reference> <width>2048</width> <height>1536</height> <html_attribution><a href="https://maps.google.com/maps/contrib/103073818292552522030">A Google User</a></html_attribution> </photo> <user_ratings_total>99</user_ratings_total> <place_id>ChIJxRjqYTiuEmsRGebAA_chDLE</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</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> <result> <name>Australian Cruise Group</name> <vicinity>6 Cirular Quay, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8609391</lat> <lng>151.2098735</lng> </location> <viewport> <southwest> <lat>-33.8622889</lat> <lng>151.2085237</lng> </southwest> <northeast> <lat>-33.8595893</lat> <lng>151.2112233</lng> </northeast> </viewport> </geometry> <rating>4.4</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJpU8KgUKuEmsRKErVGEaa11w</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uECGcpPB2lEO6gIB3QzHeviDhXcG-RV3TXuJPiBHGWbDxnflOhymebF45afUMBIW9r3xC2_gHfiqicV4VnooMJ2-Kwy0YocFXk1_0kkmR1HPV2D9kN9h-yPVK5d6oSPMdmY4MjCut3n8Tv9vt6iu44DDnafb2j78R34EcLQ4iFl0sots</photo_reference> <width>2048</width> <height>1536</height> <html_attribution><a href="https://maps.google.com/maps/contrib/113088009011192061895">Keith Bauman</a></html_attribution> </photo> <user_ratings_total>5</user_ratings_total> <place_id>ChIJpU8KgUKuEmsRKErVGEaa11w</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46Q5+JW</global_code> <compound_code>46Q5+JW Sydney, New South Wales</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> <result> <name>Rhythmboat Cruises</name> <vicinity>King Street Wharf, King St, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8686058</lat> <lng>151.2018206</lng> </location> <viewport> <southwest> <lat>-33.8699997</lat> <lng>151.2005721</lng> </southwest> <northeast> <lat>-33.8673000</lat> <lng>151.2032718</lng> </northeast> </viewport> </geometry> <rating>3.9</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJyWEHuEmuEmsRm9hTkapTCrk</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEAP5i23uwF3dotBD71Tr0YcEXCHnPOem0CKzKev5YX5dvp63wX7rbLZ3bHNNshIf9P0v3z6GKdF8yJkX3wxXWvzv7EfLwWbwGXYkA-vrXm72ek66P1FlNtNHcbIIyF9HQ1MDXZAhwLcnNJObbk8z9lKmCkBQJCQnkLsGHshZ_ZZCM6L</photo_reference> <width>4032</width> <height>2269</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104066891898402903288">Rhythmboat Sydney Harbour Cruises</a></html_attribution> </photo> <user_ratings_total>30</user_ratings_total> <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+HP</global_code> <compound_code>46J2+HP Sydney, New South Wales</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> <result> <name>Glass Island</name> <vicinity>37 Bank St, Pyrmont</vicinity> <type>bar</type> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8712692</lat> <lng>151.1898651</lng> </location> <viewport> <southwest> <lat>-33.8722276</lat> <lng>151.1887564</lng> </southwest> <northeast> <lat>-33.8695279</lat> <lng>151.1914560</lng> </northeast> </viewport> </geometry> <rating>4.1</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJnScuboavEmsRyh-FGxhc3pw</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uECzZC-aNaQunm_EMgTFeFyR5-u7E19MSZNuRbK14Tq-GxK-glsLoeqtmdOkA307MesbO6Xqau_7bGM4w5vwxMnPPkc8tEQniNQjgC1M1g9OpMwdd4_8nhmBwOMkzUZk1KU0R9CFYxx7YY5a-HywQSK8kTr1FLXX3y23bSkaDvsgenBr</photo_reference> <width>6720</width> <height>4480</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117745044320706972021">A Google User</a></html_attribution> </photo> <user_ratings_total>90</user_ratings_total> <place_id>ChIJnScuboavEmsRyh-FGxhc3pw</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH45HQ+FW</global_code> <compound_code>45HQ+FW Pyrmont, New South Wales</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> <result> <name>Junk Lounge</name> <vicinity>Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8587614</lat> <lng>151.2100004</lng> </location> <viewport> <southwest> <lat>-33.8600771</lat> <lng>151.2084323</lng> </southwest> <northeast> <lat>-33.8573774</lat> <lng>151.2111319</lng> </northeast> </viewport> </geometry> <rating>4.1</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon> <reference>ChIJq9W3HZOvEmsRYtKNTRmq34M</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEBNQHy0vHfeUWJid28kkZIf4EcgMp50UmkpvhoYPwZJBYImlASnKV4fHlaXTlNQI8H_jUqDpToiMwFOE2XsDpHBdLeZGxpoMq5ThL1gSEMo1zp9U_Pd5jhamilQbpkEeZN_CVeHLAnOX5CG21IF8pda1Zj8IuuENzaKi2BLNQ5TCyYq</photo_reference> <width>1080</width> <height>608</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104473997089847488714">A Google User</a></html_attribution> </photo> <price_level>2</price_level> <user_ratings_total>63</user_ratings_total> <place_id>ChIJq9W3HZOvEmsRYtKNTRmq34M</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46R6+F2</global_code> <compound_code>46R6+F2 The Rocks, New South Wales</compound_code> </plus_code> <icon_background_color>#FF9E67</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri> </result> <result> <name>Sydney New Year's Eve Cruises</name> <vicinity>King Street Wharf 5, 32 The Promenade, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8677035</lat> <lng>151.2017297</lng> </location> <viewport> <southwest> <lat>-33.8690456</lat> <lng>151.2004785</lng> </southwest> <northeast> <lat>-33.8663460</lat> <lng>151.2031781</lng> </northeast> </viewport> </geometry> <rating>5.0</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJ__8_hziuEmsR27ucFXECfOg</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEB3hrLc-p5rV8oczY8fo4vdDdw1c0ZXLzbcgek15WzOon1Qd3WbMfmx994E05fFb5Tt1E60Iux0jaEwGkoy477ru-ZYRD1KUZrfMNw46ciZhnHRD2ZX_nWVYkw2VG_AdEDw1DJ3YQEuDP4EJ5IpsoKianbWyIlmaeuy63TfjdvuFs18</photo_reference> <width>2400</width> <height>1600</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115281801304517408477">A Google User</a></html_attribution> </photo> <user_ratings_total>5</user_ratings_total> <place_id>ChIJ__8_hziuEmsR27ucFXECfOg</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</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> <result> <name>King Street Wharf Darling Harbour</name> <vicinity>The Promenade, Lime St, Sydney</vicinity> <type>tourist_attraction</type> <type>bowling_alley</type> <type>convenience_store</type> <type>bar</type> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>store</type> <type>establishment</type> <geometry> <location> <lat>-33.8669866</lat> <lng>151.2017231</lng> </location> <viewport> <southwest> <lat>-33.8683316</lat> <lng>151.2004351</lng> </southwest> <northeast> <lat>-33.8656320</lat> <lng>151.2031347</lng> </northeast> </viewport> </geometry> <rating>4.4</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJkfDzJ72vEmsR8xtYbk5f0p0</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEACFUVsoIAR-DdQfFF-95EUG-vLZ4rE0twMHUMam4JM7qPjrfmrVpC80g8CHtMEcimKBxtiGYaEVp7dw12FhfkJw8hZI-bK4Ls9BY3AnvdoUbfVkBvLC7yqT5ly-gMW2ZT8rLc5-mKaZHbWZyZEPgWs84Qd6KPnEKRx6dGNEevYaUlL</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/101920674986627213698">朱品貞</a></html_attribution> </photo> <user_ratings_total>3213</user_ratings_total> <place_id>ChIJkfDzJ72vEmsR8xtYbk5f0p0</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46M2+6M</global_code> <compound_code>46M2+6M Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#13B5C7</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> <result> <name>The Little Snail Restaurant</name> <vicinity>3/50 Murray St, Pyrmont</vicinity> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8703830</lat> <lng>151.1979245</lng> </location> <viewport> <southwest> <lat>-33.8717106</lat> <lng>151.1964706</lng> </southwest> <northeast> <lat>-33.8690109</lat> <lng>151.1991703</lng> </northeast> </viewport> </geometry> <rating>4.5</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon> <reference>ChIJtwapWjeuEmsRcxV5JARHpSk</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEB9EuRqd4be_9HrlUI7lbC5aDokS8UASO_ogA9OFQwEZsFD_jXDwK2Xc2kQm_wDE9TBI_20Na4TcRkgZoers93pw9cJ5RAbedKbUYAvAJz9c-zWKdqRd7pWaOlInQmbJVohI4ZsqbtlhynDqmfgX1SIccGuh066nlxyX7oFvYoLSbNb</photo_reference> <width>1350</width> <height>900</height> <html_attribution><a href="https://maps.google.com/maps/contrib/114727320476039103791">The Little Snail</a></html_attribution> </photo> <price_level>2</price_level> <user_ratings_total>1916</user_ratings_total> <place_id>ChIJtwapWjeuEmsRcxV5JARHpSk</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH45HX+R5</global_code> <compound_code>45HX+R5 Pyrmont, New South Wales</compound_code> </plus_code> <icon_background_color>#FF9E67</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri> </result> </PlaceSearchResponse>
PlacesNearbySearchResponse
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ต้องระบุ | Array<string> |
อาจมีการระบุแหล่งที่มาเกี่ยวกับข้อมูลนี้ซึ่งต้องแสดงต่อผู้ใช้ (ข้อมูลบางรายการอาจไม่มีการระบุแหล่งที่มา) |
|
ต้องระบุ | Array<Place> |
มีอาร์เรย์ของสถานที่
คำขอการค้นหาสถานที่ จะแสดงผลชุดย่อยของฟิลด์ที่คำขอรายละเอียดสถานที่แสดงผล หากฟิลด์ที่ต้องการไม่ได้
แสดงผลโดยการค้นหาสถานที่ คุณสามารถใช้การค้นหาสถานที่เพื่อรับ
place_id จากนั้นใช้รหัสสถานที่ดังกล่าวเพื่อส่งคำขอรายละเอียดสถานที่
ดูข้อมูลเพิ่มเติมได้ที่สถานที่ |
|
ต้องระบุ | PlacesSearchStatus |
มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่อง เพื่อช่วยคุณติดตามหาสาเหตุที่คำขอไม่สำเร็จ ดูข้อมูลเพิ่มเติมได้ที่ PlacesSearchStatus |
|
ไม่บังคับ | สตริง |
เมื่อบริการแสดงรหัสสถานะอื่นที่ไม่ใช่ |
|
ไม่บังคับ | Array<string> |
เมื่อบริการแสดงข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของคำขอ อาจมี |
|
ไม่บังคับ | สตริง |
มีโทเค็นที่ใช้เพื่อแสดงผลลัพธ์เพิ่มเติมได้สูงสุด 20 รายการ ระบบจะไม่แสดง next_page_token หากไม่มีผลลัพธ์เพิ่มเติมที่จะแสดง จำนวนผลลัพธ์สูงสุดที่แสดงได้คือ 60 รายการ ระหว่างตอนที่ออก next_page_token กับตอนที่โทเค็นจะใช้งานได้อาจมีความล่าช้าเล็กน้อย |
PlacesSearchStatus
รหัสสถานะที่บริการส่งกลับ
OKซึ่งหมายความว่าคำขอ API สำเร็จ-
ZERO_RESULTSซึ่งหมายความว่าการค้นหาสำเร็จแต่ ไม่พบผลลัพธ์ ปัญหานี้อาจเกิดขึ้นหากการค้นหาผ่านlatlngในสถานที่ตั้งระยะไกล -
INVALID_REQUESTแสดงว่าคำขอ API มีรูปแบบไม่ถูกต้อง โดยทั่วไปเกิดจากไม่มีพารามิเตอร์การค้นหาที่จำเป็น (locationหรือradius) -
OVER_QUERY_LIMITที่ระบุข้อมูลต่อไปนี้- คุณส่งคำขอเกินขีดจำกัด QPS
- บัญชีของคุณไม่ได้เปิดใช้การเรียกเก็บเงิน
- ใช้เครดิต $200 รายเดือนหรือโควต้าการใช้งานที่กำหนดเองเกินแล้ว
- วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
-
REQUEST_DENIEDซึ่งระบุว่าคำขอของคุณถูกปฏิเสธ โดยทั่วไปเนื่องจากสาเหตุต่อไปนี้- คำขอไม่มีคีย์ API
- พารามิเตอร์
keyไม่ถูกต้อง
UNKNOWN_ERRORแสดงว่าเกิดข้อผิดพลาดที่ไม่รู้จัก
สถานที่
แอตทริบิวต์ที่อธิบายสถานที่ แอตทริบิวต์บางอย่างอาจไม่พร้อมใช้งานสำหรับสถานที่บางประเภท
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ไม่บังคับ | Array<AddressComponent> |
อาร์เรย์ที่มีคอมโพเนนต์แยกต่างหากที่ใช้ได้กับที่อยู่นี้ ดูข้อมูลเพิ่มเติมได้ที่ 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 จะรวมไว้ด้วยนอกเหนือจากฟิลด์ที่อยู่ที่จัดรูปแบบแล้ว |
|
ไม่บังคับ | สตริง |
มีหมายเลขโทรศัพท์ของสถานที่ใน รูปแบบท้องถิ่น |
|
ไม่บังคับ | เรขาคณิต |
มีตำแหน่งและวิวพอร์ตสำหรับตำแหน่ง ดูข้อมูลเพิ่มเติมได้ที่เรขาคณิต |
|
ไม่บังคับ | สตริง |
มี 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 ดูข้อมูลเพิ่มเติมได้ที่ PlusCode |
|
ไม่บังคับ | ตัวเลข |
ระดับราคาของสถานที่ในระดับ 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
รูปภาพของสถานที่ คุณเข้าถึงรูปภาพได้ผ่าน 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 สำหรับรูปภาพ |
|
ต้องระบุ | สตริง |
สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอ 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" ลงในรีวิวได้ |
การเข้าถึงผลลัพธ์เพิ่มเติม
โดยค่าเริ่มต้น การตอบกลับแต่ละครั้งจะแสดงestablishmentผลการค้นหาestablishmentสูงสุด 20 รายการต่อคำค้นหา อย่างไรก็ตาม การค้นหาแต่ละครั้งอาจแสดงผลการค้นหาได้สูงสุด 60 รายการ โดยแบ่งออกเป็น 3 หน้า หากการค้นหาแสดงผลมากกว่า 20 รายการ การตอบกลับการค้นหาจะมีค่าเพิ่มเติมคือ next_page_token ส่งค่าของ
next_page_token ไปยังพารามิเตอร์ pagetoken ของ
คำขอใหม่เพื่อดูผลลัพธ์ชุดถัดไป
- หาก
next_page_tokenเป็นค่าว่างหรือไม่แสดงผล แสดงว่าไม่มี ผลลัพธ์เพิ่มเติม - การลองส่งคำขออีกครั้งโดยใช้
next_page_tokenเดิมจะแสดงผลลัพธ์ในหน้าถัดไป - การตั้งค่า
pagetokenจะทําให้ระบบไม่สนใจพารามิเตอร์อื่นๆ - คุณขอหน้าใหม่ได้สูงสุด 2 ครั้งหลังจาก การค้นหาเดิม
- คำขอแต่ละรายการ รวมถึงคำขอที่ใช้
next_page_tokenจะนับเป็นคำขอเดียวตามโควต้าการใช้งานของคุณและจะมีการเรียกเก็บเงิน แยกกัน - โดยจะมีความล่าช้า 2-3 วินาทีระหว่างเวลาที่ออก
next_page_tokenกับเวลาที่ ใช้ได้ การขอหน้าถัดไปก่อนที่หน้าจะพร้อมใช้งานจะส่งคืนการตอบกลับINVALID_REQUESTระบบจะเรียกเก็บเงินสำหรับคำขอที่มีnext_page_tokenเสมอ
ตัวอย่างเช่น ในคำค้นหาด้านล่าง เราค้นหาร้านอาหารใกล้ดาร์ลิงฮาร์เบอร์ในซิดนีย์ ออสเตรเลีย และจัดอันดับผลการค้นหาตามระยะทาง คุณจะเห็น
ว่าการตอบกลับมีพร็อพเพอร์ตี้ next_page_token
{
"html_attributions" : [],
"next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
"results" : [...]
"status" : "OK"
}หากต้องการดูผลลัพธ์ชุดถัดไป คุณสามารถส่งคำค้นหาใหม่โดยส่ง
ผลลัพธ์ของ next_page_token ไปยังพารามิเตอร์ pagetoken
เช่น
https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY