การค้นหาในบริเวณใกล้เคียง (เดิม) ช่วยให้คุณค้นหาสถานที่ภายในพื้นที่ที่ระบุได้ คุณสามารถปรับแต่งคำขอค้นหาได้โดยระบุคีย์เวิร์ดหรือระบุประเภทสถานที่ที่ต้องการค้นหา
คำขอการค้นหาในบริเวณใกล้เคียง (เดิม)
คำขอการค้นหาในบริเวณใกล้เคียง (เดิม) คือ 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 Main Street" โดยต้องเป็นชื่อสถานที่ ที่อยู่ หรือหมวดหมู่ของสถานที่ประกอบการ อินพุตประเภทอื่นๆ อาจทำให้เกิดข้อผิดพลาดและไม่รับประกันว่าจะแสดงผลลัพธ์ที่ถูกต้อง บริการ Google Places จะแสดงผลลัพธ์ที่ตรงกันซึ่งเป็นไปได้โดยอิงตามสตริงนี้ และจัดเรียงผลลัพธ์ตามความเกี่ยวข้องที่รับรู้
การระบุข้อมูลตำแหน่งอย่างชัดเจนโดยใช้พารามิเตอร์นี้อาจขัดแย้งกับพารามิเตอร์ location, radius และ rankby ซึ่งทำให้เกิดผลลัพธ์ที่ไม่คาดคิด
หากละเว้นพารามิเตอร์นี้ ระบบจะไม่แสดงสถานที่ที่มี business_status เป็น CLOSED_TEMPORARILY หรือ CLOSED_PERMANENTLY
-
ภาษา
ภาษาที่จะแสดงผลลัพธ์
- ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยครั้ง รายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageไว้ API จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัวAccept-Language - API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกแสดงผลและลำดับการแสดงผล โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อสำหรับประเภทถนน หรือคำพ้องความหมายที่อาจใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของคำว่าถนนในภาษาฮังการี
-
maxprice
จำกัดผลการค้นหาเฉพาะสถานที่ที่อยู่ในช่วงที่ระบุเท่านั้น ค่าที่ถูกต้องมีตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (ราคาแพงที่สุด) จำนวนเงินที่แน่นอนซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค
-
minprice
จำกัดผลการค้นหาเฉพาะสถานที่ที่อยู่ในช่วงที่ระบุเท่านั้น ค่าที่ถูกต้องมีตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (ราคาแพงที่สุด) จำนวนเงินที่แน่นอนซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค
-
name
เทียบเท่ากับ
keywordค่าในช่องนี้จะรวมกับค่าในช่องkeywordและส่งเป็นส่วนหนึ่งของสตริงการค้นหาเดียวกัน -
opennow
แสดงเฉพาะสถานที่ที่เปิดให้บริการ ณ เวลาที่ส่งคำค้นหา ระบบจะไม่แสดงสถานที่ที่ไม่ได้ระบุเวลาทำการในฐานข้อมูล Google Places หากคุณรวมพารามิเตอร์นี้ไว้ในการค้นหา
-
pagetoken
แสดงผลการค้นหาที่เรียกใช้ก่อนหน้านี้สูงสุด 20 รายการ การตั้งค่าพารามิเตอร์
pagetokenจะทำการค้นหาด้วยพารามิเตอร์เดียวกันกับที่ใช้ก่อนหน้านี้ โดยระบบจะไม่สนใจพารามิเตอร์ทั้งหมดนอกเหนือจากpagetoken -
rankby
ระบุลำดับที่แสดงผลลัพธ์ ค่าที่เป็นไปได้มีดังนี้
-
prominence(ค่าเริ่มต้น) ตัวเลือกนี้จะจัดเรียงผลลัพธ์ตามความสำคัญ การจัดอันดับจะให้ความสำคัญกับสถานที่ที่โดดเด่นภายในรัศมีที่กำหนดมากกว่าสถานที่ใกล้เคียงที่ตรงกันแต่มีความโดดเด่นน้อยกว่า ความโดดเด่นอาจได้รับผลกระทบจากการจัดอันดับของสถานที่ในดัชนีของ Google, ความนิยมทั่วโลก และปัจจัยอื่นๆ เมื่อระบุความโดดเด่น คุณต้องระบุพารามิเตอร์radius -
distanceตัวเลือกนี้จะให้น้ำหนักผลการค้นหาตามลำดับจากน้อยไปมากตามระยะทางจากสถานที่ที่ระบุ เมื่อระบุdistanceคุณต้องระบุkeyword,nameหรือtypeอย่างน้อย 1 รายการ และไม่อนุญาตให้ระบุradius
-
-
ประเภท
จำกัดผลการค้นหาเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุ คุณระบุได้เพียงประเภทเดียวเท่านั้น หากคุณระบุมากกว่า 1 ประเภท API จะละเว้นประเภททั้งหมดที่ตามหลังรายการแรก
-
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", }, // ... ], "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> <!-- ... --> </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ซึ่งบ่งบอกถึงข้อผิดพลาดที่ไม่รู้จัก
สถานที่
การตอบกลับการค้นหาสถานที่จะแสดงชุดย่อยของช่องสถานที่ต่อไปนี้ แอตทริบิวต์บางรายการอาจใช้ไม่ได้กับสถานที่บางประเภท หากต้องการดึงข้อมูลช่องที่การค้นหาสถานที่ไม่แสดงผล เช่น address_components, formatted_phone_number, reviews หรือ website ให้ส่ง place_id ที่แสดงผลในคำขอรายละเอียดสถานที่ (เดิม) ดูความพร้อมใช้งานของฟิลด์และระดับราคาในปลายทางต่างๆ ได้ที่ฟิลด์ข้อมูลสถานที่ (เดิม)
| ช่อง | ประเภท | คำอธิบาย |
|---|---|---|
business_status |
string |
ระบุสถานะการดำเนินการของสถานที่ หากเป็นธุรกิจ ได้แก่ OPERATIONAL, CLOSED_TEMPORARILY หรือ CLOSED_PERMANENTLY ละเว้นหากไม่มีข้อมูลสถานะ
|
formatted_address |
string |
ที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้ แสดงผลโดยการค้นหาข้อความ (เดิม) และค้นหาสถานที่ (เดิม) อย่าแยกวิเคราะห์ที่อยู่ที่มีการจัดรูปแบบแบบเป็นโปรแกรม แต่ให้ขอ address_components ในรายละเอียดสถานที่ (เดิม) แทน
|
geometry |
Geometry
|
มี location ที่เข้ารหัสพิกัดภูมิศาสตร์พร้อมพิกัด lat และ lng และ viewport ที่ต้องการพร้อมขอบเขต northeast และ southwest
|
icon |
string |
URL ของไอคอนที่แนะนำซึ่งคุณสามารถแสดงเมื่อระบุผลลัพธ์นี้ในแผนที่ |
icon_background_color
|
string |
รหัสสีแบบเลขฐาน 16 เริ่มต้นสำหรับหมวดหมู่ของสถานที่ |
icon_mask_base_uri |
string |
URL ฐานของไอคอนที่แนะนำ โดยไม่มีนามสกุลประเภทไฟล์ SVG หรือ PNG |
name |
string |
ชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดงผล สำหรับผลการค้นหา establishment ค่านี้มักจะเป็นชื่อธุรกิจที่ทำ Canonical
|
opening_hours |
PlaceOpeningHours
|
ข้อมูลเวลาทำการ ปลายทางการค้นหาสถานที่จะแสดงเฉพาะฟิลด์ย่อยบูลีน open_now เท่านั้น โปรดขอ opening_hours ในรายละเอียดสถานที่ (เดิม) สำหรับ periods และ weekday_text
|
permanently_closed |
boolean |
เลิกใช้งาน: ใช้ business_status เพื่อตรวจสอบสถานะการดำเนินการของธุรกิจ
|
photos |
Array<PlacePhoto>
|
อาร์เรย์ของออบเจ็กต์ PlacePhoto ซึ่งแต่ละออบเจ็กต์ประกอบด้วย photo_reference, height, width และ html_attributions ดูรายละเอียดการใช้งานได้ที่รูปภาพของสถานที่ (เดิม)
|
place_id |
string |
ตัวระบุข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน ส่งรหัสนี้ในพารามิเตอร์ place_id ของคำขอรายละเอียดสถานที่ (เดิม) ดูภาพรวมรหัสสถานที่
|
plus_code |
PlusCode
|
ข้อมูลอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูด ซึ่งมี global_code และ compound_code (ไม่บังคับ)
|
price_level |
integer |
ระดับราคาของสถานที่ในสเกลตั้งแต่ 0 ถึง 4 โดยเรียงจากราคาถูกที่สุดไปจนถึงแพงที่สุด ดูprice_level
|
rating |
number |
คะแนนของสถานที่ ตั้งแต่ 1.0 ถึง 5.0 โดยอิงตามรีวิวจากผู้ใช้ที่รวบรวมมา
|
reference |
string |
เลิกใช้งานแล้ว: โปรดใช้ place_id แทน
|
scope |
string |
เลิกใช้งานแล้ว: ระบุขอบเขตของ place_id ซึ่งจะเป็น GOOGLE เสมอ แสดงผลโดยการค้นหาในบริเวณใกล้เคียง (เดิม)
|
types |
Array<string> |
อาร์เรย์ของประเภทฟีเจอร์ที่อธิบายผลลัพธ์ที่ระบุ ดูประเภทสถานที่ (เดิม) |
user_ratings_total |
integer |
จำนวนการให้คะแนนทั้งหมดสำหรับสถานที่นี้ โดยมีหรือไม่มีข้อความรีวิว |
vicinity |
string |
ที่อยู่แบบย่อของสถานที่ ซึ่งรวมถึงชื่อถนน หมายเลขถนน และท้องถิ่น โดยไม่มีรัฐหรือจังหวัด รหัสไปรษณีย์ หรือประเทศ แสดงผลโดยการค้นหาในบริเวณใกล้เคียง (เดิม) |
การเข้าถึงผลลัพธ์เพิ่มเติม
โดยค่าเริ่มต้น การตอบกลับแต่ละครั้งจะแสดงผลการค้นหา 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