คำขอค้นหาสถานที่ (เดิม) จะรับอินพุตข้อความและแสดงผลสถานที่ อินพุตอาจเป็นข้อมูลข้อความของ Places ประเภทใดก็ได้ เช่น ชื่อ ที่อยู่ หรือหมายเลขโทรศัพท์ คำขอต้องเป็นสตริง คำขอค้นหาสถานที่ (เดิม) ที่ใช้ข้อมูลที่ไม่ใช่สตริง เช่น พิกัดละติจูด/ลองจิจูดหรือ Plus Code จะทำให้เกิดข้อผิดพลาด
คำขอค้นหาสถานที่ (เดิม)
คำขอค้นหาสถานที่ (เดิม) คือ HTTP URL ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters
โดยที่ output อาจเป็นค่าใดค่าหนึ่งต่อไปนี้
json(แนะนำ) บ่งบอกถึงเอาต์พุตใน JavaScript Object Notation (JSON)xmlระบุเอาต์พุตเป็น XML
ต้องใช้พารามิเตอร์บางอย่างเพื่อเริ่มคำขอค้นหาสถานที่ (เดิม) พารามิเตอร์ทั้งหมดจะแยกกันโดยใช้อักขระแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL
พารามิเตอร์ที่จำเป็น
อินพุต
สตริงข้อความที่จะค้นหา ต้องเป็นชื่อสถานที่ ที่อยู่ หรือหมายเลขโทรศัพท์ (เช่น "123 ถนนสุขุมวิท" หรือ "ศาลากลาง")
inputtype
ประเภทของอินพุต ซึ่งอาจเป็น textquery หรือ phonenumber ก็ได้ หมายเลขโทรศัพท์ต้องอยู่ในรูปแบบระหว่างประเทศ (ขึ้นต้นด้วยเครื่องหมายบวก ("+") ตามด้วยรหัสประเทศ แล้วตามด้วยหมายเลขโทรศัพท์) ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำ E.164 ITU
พารามิเตอร์ที่ไม่บังคับ
Fields
place_id จากนั้นใช้รหัสสถานที่นั้นเพื่อส่งคำขอรายละเอียดสถานที่ (เดิม) ดูข้อมูลเพิ่มเติมเกี่ยวกับช่องที่ไม่พร้อมใช้งานในคำขอการค้นหาสถานที่ (เดิม) ได้ที่การรองรับช่องของ Places API
ใช้พารามิเตอร์ fields เพื่อระบุรายการประเภทข้อมูลสถานที่ที่คั่นด้วยคอมมาที่จะแสดงผล ตัวอย่างเช่น
fields=formatted_address,name,geometry ใช้เครื่องหมายทับเมื่อระบุค่าผสม ตัวอย่างเช่น
opening_hours/open_now
ช่องจะแบ่งออกเป็น 3 หมวดหมู่การเรียกเก็บเงิน ได้แก่ พื้นฐาน ข้อมูลติดต่อ และ บรรยากาศ ระบบจะเรียกเก็บเงินสำหรับช่องข้อมูลพื้นฐานในอัตราฐาน และเรียกเก็บเงินสำหรับช่องข้อมูลรายชื่อติดต่อและบรรยากาศในอัตราที่สูงกว่า ระบบจะเรียกเก็บเงิน SKU พื้นฐาน, SKU ข้อมูลติดต่อ และ SKU บรรยากาศเพิ่มเติมจาก SKU พื้นฐาน (รายละเอียดสถานที่, ค้นหาสถานที่, การค้นหาในบริเวณใกล้เคียง หรือการค้นหาข้อความ) สำหรับคำขอที่เรียกใช้ SKU เหล่านั้น ดูข้อมูลเพิ่มเติมได้ที่แผ่นข้อมูลราคา
Basic
หมวดหมู่พื้นฐานประกอบด้วยฟิลด์ต่อไปนี้
address_components, adr_address,
business_status, formatted_address,
geometry, icon, icon_mask_base_uri,
icon_background_color, name,
permanently_closed (เลิกใช้งานแล้ว), photo, place_id, plus_code,
type, url, utc_offset,
vicinity, wheelchair_accessible_entrance
การติดต่อ
หมวดหมู่รายชื่อติดต่อประกอบด้วยช่องต่อไปนี้
current_opening_hours, formatted_phone_number,
international_phone_number, opening_hours,
secondary_opening_hours, website
บรรยากาศ
หมวดหมู่บรรยากาศประกอบด้วยช่องต่อไปนี้
curbside_pickup, delivery, dine_in,
editorial_summary, price_level,
rating, reservable, reviews,
serves_beer, serves_breakfast,
serves_brunch, serves_dinner,
serves_lunch, serves_vegetarian_food,
serves_wine, takeout,
user_ratings_total
html_attributions พร้อมกับการเรียกทุกครั้ง ไม่ว่าจะมีการขอช่องดังกล่าวหรือไม่ก็ตาม
ภาษา
ภาษาที่จะแสดงผลลัพธ์
- ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยครั้ง รายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageไว้ API จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัวAccept-Language - API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกแสดงผลและลำดับการแสดงผล โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมายที่อาจใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของคำว่าถนนในภาษาฮังการี
locationbias
แสดงผลการค้นหาในพื้นที่ที่ระบุ โดยระบุรัศมีบวกละติจูด/ลองจิจูด หรือคู่ละติจูด/ลองจิจูด 2 คู่ที่แสดงจุดของสี่เหลี่ยมผืนผ้า หากไม่ได้ระบุพารามิเตอร์นี้ API จะใช้การให้น้ำหนักที่อยู่ IP โดยค่าเริ่มต้น
-
การให้น้ำหนัก IP: สั่งให้ API ใช้การให้น้ำหนักที่อยู่ IP ส่งสตริง
ipbias(ตัวเลือกนี้ไม่มีพารามิเตอร์เพิ่มเติม) -
วงกลม: สตริงที่ระบุรัศมีเป็นเมตร บวกกับละติจูด/ลองจิจูดเป็นองศาทศนิยม โดยใช้รูปแบบต่อไปนี้
circle:radius@lat,lng -
สี่เหลี่ยมผืนผ้า: สตริงที่ระบุคู่ละติจูด/ลองจิจูด 2 คู่ในหน่วยองศาทศนิยม ซึ่งแสดงจุดใต้/ตะวันตกและเหนือ/ตะวันออกของสี่เหลี่ยมผืนผ้า โดยใช้รูปแบบต่อไปนี้
rectangle:south,west|north,eastโปรดทราบว่าค่าตะวันออก/ตะวันตกจะรวมอยู่ในช่วง -180, 180 และค่าเหนือ/ใต้จะถูกจำกัดให้อยู่ในช่วง -90, 90
ตัวอย่างการค้นหาสถานที่ (เดิม)
ตัวอย่างต่อไปนี้แสดงคำขอค้นหาสถานที่ (เดิม) สำหรับ "Museum of Contemporary Art Australia" ซึ่งรวมถึงช่อง photos, formatted_address, name, rating, opening_hours และ geometry
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/findplacefromtext/json ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry &input=Museum%20of%20Contemporary%20Art%20Australia &inputtype=textquery &key=YOUR_API_KEY
ตัวอย่างต่อไปนี้แสดงคำขอค้นหาสถานที่ (เดิม) สำหรับ "Mongolian Grill" โดยใช้พารามิเตอร์ locationbias เพื่อเลือกผลลัพธ์ภายในระยะ 2,000 เมตรจากพิกัดที่ระบุ
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/findplacefromtext/json ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry &input=Mongolian%20Grill &inputtype=textquery &locationbias=circle:2000@−33.866,151.216 &key=YOUR_API_KEY
ตัวอย่างต่อไปนี้แสดงคำขอค้นหาสถานที่ (เดิม) สำหรับหมายเลขโทรศัพท์ โปรดทราบว่ารหัสโทรออกต่างประเทศ "+" ได้รับการเข้ารหัสเป็น %2B เพื่อให้คำขอนี้เป็น URL ที่เป็นไปตามข้อกำหนด หากไม่เข้ารหัส คำนำหน้า + จะถูกถอดรหัสเป็นช่องว่างบนเซิร์ฟเวอร์ ส่งผลให้การค้นหาหมายเลขโทรศัพท์ไม่ถูกต้อง
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/findplacefromtext/json ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry &input=%2B16502530000 &inputtype=phonenumber &key=YOUR_API_KEY
การตอบกลับของ Find Place (เดิม)
การตอบกลับของ Find Place (เดิม) จะมีเฉพาะประเภทข้อมูลที่ระบุโดยใช้พารามิเตอร์ fields บวกกับ html_attributions ตัวอย่างต่อไปนี้แสดงการตอบกลับสำหรับคำขอค้นหาสถานที่ (เดิม) สำหรับ "Museum of Contemporary Art Australia" รวมถึงช่อง formatted_address, geometry, name, opening_hours, photos, rating
JSON
{ "candidates": [ { "formatted_address": "140 George St, The Rocks NSW 2000, Australia", "geometry": { "location": { "lat": -33.8599358, "lng": 151.2090295 }, "viewport": { "northeast": { "lat": -33.85824377010728, "lng": 151.2104386798927 }, "southwest": { "lat": -33.86094342989272, "lng": 151.2077390201073 }, }, }, "name": "Museum of Contemporary Art Australia", "opening_hours": { "open_now": false }, "rating": 4.4, }, ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <FindPlaceFromTextResponse> <candidates> <name>Museum of Contemporary Art Australia</name> <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address> <geometry> <location> <lat>-33.8599358</lat> <lng>151.2090295</lng> </location> <viewport> <southwest> <lat>-33.8609434</lat> <lng>151.2077390</lng> </southwest> <northeast> <lat>-33.8582438</lat> <lng>151.2104387</lng> </northeast> </viewport> </geometry> <rating>4.4</rating> <opening_hours> <open_now>false</open_now> </opening_hours> </candidates> <status>OK</status> </FindPlaceFromTextResponse>
PlacesFindPlaceFromTextResponse
| ช่อง | ต้องระบุ | ประเภท | คำอธิบาย |
|---|---|---|---|
|
ต้องระบุ | Array<Place> |
มีอาร์เรย์ของสถานที่ที่เป็นไปได้
คำขอการค้นหาสถานที่ (เดิม) จะแสดงผลชุดย่อยของฟิลด์ที่แสดงผลโดยคำขอรายละเอียดสถานที่ (เดิม) หากการค้นหาสถานที่ (เดิม) ไม่แสดงช่องที่คุณต้องการ คุณสามารถใช้การค้นหาสถานที่ (เดิม) เพื่อรับ place_id แล้วใช้รหัสสถานที่นั้นเพื่อส่งคำขอรายละเอียดสถานที่ (เดิม) ได้
ดูข้อมูลเพิ่มเติมได้ที่สถานที่ |
|
ต้องระบุ | PlacesSearchStatus |
มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่องเพื่อช่วยคุณติดตามสาเหตุที่คำขอล้มเหลว ดูข้อมูลเพิ่มเติมได้ที่ PlacesSearchStatus |
|
ไม่บังคับ | สตริง |
เมื่อบริการแสดงรหัสสถานะอื่นที่ไม่ใช่ |
|
ไม่บังคับ | Array<string> |
เมื่อบริการแสดงข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของคำขอ อาจมีช่อง |
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 |
ที่อยู่แบบย่อของสถานที่ ซึ่งรวมถึงชื่อถนน หมายเลขถนน และท้องถิ่น โดยไม่มีรัฐหรือจังหวัด รหัสไปรษณีย์ หรือประเทศ แสดงผลโดยการค้นหาในบริเวณใกล้เคียง (เดิม) |