ส่งคำขอ
คำขอ Geocoding API จะอยู่ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters
โดยที่ outputFormat อาจเป็นค่าใดค่าหนึ่งต่อไปนี้
json(แนะนำ) ระบุเอาต์พุตใน JavaScript Object Notation (JSON) หรือxmlบ่งบอกถึงเอาต์พุตใน XML
ต้องใช้ HTTPS
พารามิเตอร์บางรายการเป็นพารามิเตอร์ที่จำเป็น ในขณะที่บางรายการเป็นตัวเลือก พารามิเตอร์จะแยกกันโดยใช้อักขระแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL
ส่วนที่เหลือของหน้านี้จะอธิบายการเข้ารหัสพิกัดภูมิศาสตร์และการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับแยกกัน เนื่องจากคำขอแต่ละประเภทมีพารามิเตอร์ที่แตกต่างกัน
พารามิเตอร์การเข้ารหัสพิกัดภูมิศาสตร์ (การค้นหาละติจูด/ลองจิจูด)
พารามิเตอร์ที่จำเป็นในคำขอการเข้ารหัสพิกัดภูมิศาสตร์
key— คีย์ API ของแอปพลิเคชัน คีย์นี้จะระบุแอปพลิเคชันของคุณเพื่อวัตถุประสงค์ในการจัดการโควต้า ดูวิธีรับคีย์คุณต้องระบุ
addressหรือcomponentsหรือทั้ง 2 อย่างในคำขอ ดังนี้address— ที่อยู่ไปรษณีย์หรือ Plus Code ที่ต้องการเข้ารหัสพิกัดภูมิศาสตร์ หมายเหตุ: การเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่จะไม่แปลงพิกัดละติจูดและลองจิจูด หรือสตริงอื่นๆ ที่ไม่มีโครงสร้างซึ่งไม่ได้แสดงถึงที่อยู่หรือ Plus Code ระบบไม่รองรับคำขอที่ใช้สตริงดังกล่าว และอาจทำให้เกิดการตอบกลับข้อผิดพลาดหรือลักษณะการทำงานที่ไม่ได้ระบุ ตัวอย่างคำค้นหาที่ไม่รองรับมีดังนี้
ระบุที่อยู่ตามรูปแบบที่ใช้โดยบริการไปรษณีย์แห่งชาติของประเทศที่เกี่ยวข้อง หลีกเลี่ยงองค์ประกอบที่อยู่เพิ่มเติม เช่น ชื่อธุรกิจ และหมายเลขยูนิต ห้องชุด หรือชั้น องค์ประกอบที่อยู่ควรคั่นด้วยช่องว่าง (แสดงที่นี่เป็น URL ที่หลีกเป็นประเภทคำค้นหา ตัวอย่าง พิกัดละติจูดและลองจิจูด โปรดใช้การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับแทน "37.422131,-122.084801" มีแนวคิดหรือข้อจำกัดมากเกินไป เช่น ชื่อสถานที่ ถนน หรือเมืองหลายแห่งในคำค้นหาเดียว "Market Street San Francisco San Jose Airport" องค์ประกอบของที่อยู่ทางไปรษณีย์ไม่แสดงใน Google Maps "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"ชื่อธุรกิจ เครือธุรกิจ หรือหมวดหมู่ที่รวมกับสถานที่ตั้งซึ่งไม่มีธุรกิจเหล่านี้อยู่ "Tesco ใกล้ Dallas, Texas" คำค้นหาที่กำกวมซึ่งตีความได้หลายแบบ "จุดส่งคืนที่ชาร์จ" ชื่อเดิมที่ไม่ได้ใช้แล้ว "Middlesex United Kingdom" องค์ประกอบหรือเจตนาที่ไม่ใช่เชิงภูมิสารสนเทศ "มีเรือกี่ลำในท่าเรือเวนทูรา" ชื่อที่ไม่เป็นทางการหรือชื่อที่ตั้งขึ้นเอง "The Jenga"
"The Helter Skelter"%20)address=24%20Sussex%20Drive%20Ottawa%20ON
%2Bและการเว้นวรรคจะได้รับการหลีกเลี่ยง URL เป็น%20)- รหัสสากล คือรหัสพื้นที่ 4 หลักและรหัสท้องถิ่น 6 หลักขึ้นไป (849VCWC8+R9 คือ
849VCWC8%2BR9) - รหัสผสมคือรหัสท้องถิ่น 6 หลักขึ้นไปที่มีการระบุตำแหน่งชัดเจน (CWC8+R9 Mountain View, CA, USA คือ
CWC8%2BR9%20Mountain%20View%20CA%20USA)
- รหัสสากล คือรหัสพื้นที่ 4 หลักและรหัสท้องถิ่น 6 หลักขึ้นไป (849VCWC8+R9 คือ
components— ตัวกรองคอมโพเนนต์ที่มีองค์ประกอบคั่นด้วยไปป์ (|) ระบบจะยอมรับตัวกรองคอมโพเนนต์เป็นพารามิเตอร์ที่ไม่บังคับด้วยหากมีการระบุaddressแต่ละองค์ประกอบในตัวกรองคอมโพเนนต์ประกอบด้วยคู่component:valueและจำกัดผลลัพธ์จากโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์อย่างสมบูรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการกรองคอมโพเนนต์ด้านล่าง
ดูคำแนะนำเพิ่มเติมได้ที่คำถามที่พบบ่อย
พารามิเตอร์ที่ไม่บังคับในคำขอการเข้ารหัสพิกัดภูมิศาสตร์
bounds— กรอบล้อมรอบของวิวพอร์ตที่ใช้ให้น้ำหนักผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์อย่างชัดเจนยิ่งขึ้น พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์จากโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์เท่านั้น แต่จะไม่จำกัดผลลัพธ์โดยสมบูรณ์ (ดูข้อมูลเพิ่มเติมได้ที่การให้น้ำหนักวิวพอร์ตด้านล่าง)language— ภาษาที่จะแสดงผลลัพธ์- ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยครั้ง รายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
- หากไม่ได้ระบุ
languageโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัวAccept-Languageหรือภาษาแม่ของโดเมนที่ส่งคำขอ - โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกแสดงผลและลำดับการแสดงผล โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อสำหรับประเภทถนน หรือคำพ้องความหมายที่อาจใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของถนนและจัตุรัสตามลำดับในภาษาฮังการี
region— รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์จากโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์เท่านั้น แต่จะไม่จำกัดผลลัพธ์โดยสมบูรณ์ (ดูข้อมูลเพิ่มเติมได้ที่การให้น้ำหนักภูมิภาคด้านล่าง) พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้องด้วยcomponents— ตัวกรองคอมโพเนนต์ที่มีองค์ประกอบคั่นด้วยไปป์ (|) ต้องระบุตัวกรองคอมโพเนนต์หากคำขอไม่มีaddressแต่ละองค์ประกอบในตัวกรองคอมโพเนนต์ประกอบด้วยคู่component:valueและจำกัดผลลัพธ์จากโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์อย่างสมบูรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการกรองคอมโพเนนต์ด้านล่างextra_computations— ใช้พารามิเตอร์นี้เพื่อระบุฟีเจอร์เพิ่มเติมต่อไปนี้ในการตอบกลับADDRESS_DESCRIPTORS— ดูรายละเอียดเพิ่มเติมได้ที่ คำอธิบายที่อยู่BUILDING_AND_ENTRANCES— ดูรายละเอียดเพิ่มเติมได้ที่ ทางเข้าและเค้าโครงอาคาร
extra_computationsในคำขอสำหรับแต่ละฟีเจอร์ เช่นextra_computations=ADDRESS_DESCRIPTORS&extra_computations=BUILDING_AND_ENTRANCES
คำตอบ
ระบบจะแสดงผลการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ในรูปแบบที่ระบุโดยแฟล็ก output ภายในคำขอ URL หรือในรูปแบบ JSON โดยค่าเริ่มต้น
ในตัวอย่างนี้ Geocoding API จะขอการตอบกลับ json สำหรับคำขอ API สำหรับคำค้นหาที่อยู่ "1600 Amphitheatre Parkway, Mountain View, CA"
คำขอนี้แสดงการใช้แฟล็ก JSON output
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
คำขอนี้แสดงการใช้แฟล็ก XML output
https://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
เลือกแท็บด้านล่างเพื่อดูตัวอย่างการตอบกลับ JSON และ XML
JSON
{ "results": [ { "address_components": [ { "long_name": "1600", "short_name": "1600", "types": [ "street_number" ] }, { "long_name": "Amphitheatre Parkway", "short_name": "Amphitheatre Pkwy", "types": [ "route" ] }, { "long_name": "Mountain View", "short_name": "Mountain View", "types": [ "locality", "political" ] }, { "long_name": "Santa Clara County", "short_name": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ] }, { "long_name": "California", "short_name": "CA", "types": [ "administrative_area_level_1", "political" ] }, { "long_name": "United States", "short_name": "US", "types": [ "country", "political" ] }, { "long_name": "94043", "short_name": "94043", "types": [ "postal_code" ] }, { "long_name": "1351", "short_name": "1351", "types": [ "postal_code_suffix" ] } ], "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry": { "location": { "lat": 37.4222804, "lng": -122.0843428 }, "location_type": "ROOFTOP", "viewport": { "northeast": { "lat": 37.4237349802915, "lng": -122.083183169709 }, "southwest": { "lat": 37.4210370197085, "lng": -122.085881130292 } } }, "place_id": "ChIJRxcAvRO7j4AR6hm6tys8yA8", "plus_code": { "compound_code": "CWC8+W7 Mountain View, CA", "global_code": "849VCWC8+W7" }, "types": [ "street_address" ] } ], "status": "OK" }
โปรดทราบว่าการตอบกลับ JSON มีองค์ประกอบรูท 2 รายการ ได้แก่
"status"มีข้อมูลเมตาเกี่ยวกับคำขอ ดูรหัสสถานะด้านล่าง"results"มีอาร์เรย์ของข้อมูลที่อยู่ที่มีการเข้ารหัสพิกัดภูมิศาสตร์และข้อมูลเรขาคณิต
โดยทั่วไปแล้ว ระบบจะแสดงผลเพียงรายการเดียวในอาร์เรย์ "results" สำหรับการค้นหาที่อยู่ แม้ว่าโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์อาจแสดงผลลัพธ์หลายรายการเมื่อการค้นหาที่อยู่ไม่ชัดเจนก็ตาม
XML
<GeocodeResponse> <status>OK</status> <result> <type>street_address</type> <formatted_address>1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA</formatted_address> <address_component> <long_name>1600</long_name> <short_name>1600</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Amphitheatre Parkway</long_name> <short_name>Amphitheatre Pkwy</short_name> <type>route</type> </address_component> <address_component> <long_name>Mountain View</long_name> <short_name>Mountain View</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Santa Clara County</long_name> <short_name>Santa Clara County</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>California</long_name> <short_name>CA</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>United States</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>94043</long_name> <short_name>94043</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>37.4224428</lat> <lng>-122.0842467</lng> </location> <location_type>ROOFTOP</location_type> <viewport> <southwest> <lat>37.4212648</lat> <lng>-122.0856069</lng> </southwest> <northeast> <lat>37.4239628</lat> <lng>-122.0829089</lng> </northeast> </viewport> </geometry> <place_id>ChIJeRpOeF67j4AR9ydy_PIzPuM</place_id> <plus_code> <global_code>849VCWC8+X8</global_code> <compound_code>CWC8+X8 Mountain View, CA</compound_code> </plus_code> </result> </GeocodeResponse>
โปรดทราบว่าการตอบกลับ XML ประกอบด้วย <GeocodeResponse> รายการเดียวและองค์ประกอบระดับบนสุด 2 รายการ ดังนี้
<status>มีข้อมูลเมตาเกี่ยวกับคำขอ ดูรหัสสถานะด้านล่าง- องค์ประกอบ
<result>ตั้งแต่ 0 รายการขึ้นไป โดยแต่ละรายการจะมีชุดข้อมูลที่อยู่และข้อมูลเรขาคณิตที่เข้ารหัสพิกัดภูมิศาสตร์ 1 ชุด
การตอบกลับ XML ยาวกว่าการตอบกลับ JSON มาก ด้วยเหตุนี้ เราขอแนะนำให้ใช้ json เป็นแฟล็กเอาต์พุตที่ต้องการ เว้นแต่บริการของคุณจะต้องใช้ xml ด้วยเหตุผลบางประการ
นอกจากนี้ การประมวลผลโครงสร้าง XML ต้องใช้ความระมัดระวังเพื่อให้คุณอ้างอิงโหนดและองค์ประกอบที่เหมาะสม ดูรูปแบบการออกแบบที่แนะนำสำหรับการประมวลผลเอาต์พุตได้ที่
การแยกวิเคราะห์ XML ด้วย XPath
- ผลลัพธ์ XML จะรวมอยู่ในองค์ประกอบ
<GeocodeResponse>รูท - JSON จะแสดงรายการที่มีองค์ประกอบหลายรายการด้วยอาร์เรย์พหูพจน์ (
types) ส่วน XML จะแสดงรายการเหล่านี้โดยใช้องค์ประกอบเอกพจน์หลายรายการ (<type>) - องค์ประกอบที่ว่างเปล่าจะแสดงผ่านอาร์เรย์ที่ว่างเปล่าใน JSON แต่จะแสดงโดยไม่มีองค์ประกอบดังกล่าวใน XML ตัวอย่างเช่น การตอบกลับที่ไม่สร้างผลลัพธ์จะแสดงผลอาร์เรย์
resultsที่ว่างเปล่าใน JSON แต่ไม่มีองค์ประกอบ<result>ใน XML
รหัสสถานะ
ฟิลด์ "status" ภายในออบเจ็กต์การตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่องเพื่อช่วยคุณติดตามสาเหตุที่การเข้ารหัสพิกัดภูมิศาสตร์ไม่ทำงาน ช่อง "status" อาจมีค่าต่อไปนี้
"OK"บ่งบอกว่าไม่มีข้อผิดพลาดเกิดขึ้น ระบบแยกวิเคราะห์ที่อยู่เรียบร้อยแล้ว และแสดงผลรหัสพิกัดภูมิศาสตร์อย่างน้อย 1 รายการ"ZERO_RESULTS"บ่งชี้ว่าการเข้ารหัสพิกัดภูมิศาสตร์สำเร็จ แต่ไม่แสดงผลลัพธ์ กรณีนี้อาจเกิดขึ้นหากมีการส่งaddressที่ไม่มีอยู่ไปยังโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์OVER_DAILY_LIMITบ่งบอกถึงสิ่งใดสิ่งหนึ่งต่อไปนี้- ไม่มีคีย์ API หรือคีย์ API ไม่ถูกต้อง
- ยังไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชีของคุณ
- เกินขีดจำกัดการใช้งานที่กำหนดเอง
- วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
ดูวิธีแก้ไขปัญหานี้ได้ที่คำถามที่พบบ่อยเกี่ยวกับ Maps
"OVER_QUERY_LIMIT"บ่งบอกว่าคุณใช้พื้นที่เก็บข้อมูลเกินโควต้า"REQUEST_DENIED"บ่งบอกว่าคำขอของคุณถูกปฏิเสธ"INVALID_REQUEST"โดยทั่วไปจะบ่งบอกว่าไม่มีการค้นหา (address,componentsหรือlatlng)"UNKNOWN_ERROR"บ่งชี้ว่าประมวลผลคำขอไม่ได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง
ข้อความแสดงข้อผิดพลาด
เมื่อโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์แสดงรหัสสถานะอื่นที่ไม่ใช่ OK อาจมีช่อง error_message เพิ่มเติมภายในออบเจ็กต์การตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ ช่องนี้มีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับสาเหตุที่อยู่เบื้องหลังรหัสสถานะที่ระบุ
ผลลัพธ์
เมื่อโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์แสดงผลลัพธ์ ระบบจะวางผลลัพธ์ไว้ในอาร์เรย์ results (JSON) แม้ว่าโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะไม่แสดงผลลัพธ์ (เช่น หากไม่มีที่อยู่) แต่ก็ยังคงแสดงอาร์เรย์ results ที่ว่างเปล่า (การตอบกลับ XML ประกอบด้วยองค์ประกอบ <result> ตั้งแต่ 0 รายการขึ้นไป)
ผลลัพธ์ทั่วไปจะมีช่องต่อไปนี้
- อาร์เรย์
types[]จะระบุประเภทของผลลัพธ์ที่แสดงผล อาร์เรย์นี้มีชุดแท็กอย่างน้อย 0 รายการที่ระบุประเภทของฟีเจอร์ที่แสดงในผลลัพธ์ ตัวอย่างเช่น รหัสพิกัดภูมิศาสตร์ของ "Chicago" จะแสดงผล "locality" ซึ่งบ่งบอกว่า "Chicago" เป็นเมือง และยังแสดงผล "political" ซึ่งบ่งบอกว่าเป็นหน่วยงานทางการเมืองด้วย ดูข้อมูลเพิ่มเติมได้ที่ประเภทที่อยู่และประเภทคอมโพเนนต์ที่อยู่ formatted_addressคือสตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่ตั้งนี้ซึ่งมักจะเป็นที่อยู่เดียวกับที่อยู่ทางไปรษณีย์ โปรดทราบว่าบางประเทศ เช่น สหราชอาณาจักร ไม่อนุญาตให้เผยแพร่ที่อยู่ทางไปรษณีย์จริงเนื่องจากข้อจำกัดด้านการอนุญาตให้ใช้สิทธิ
ที่อยู่ที่มีการจัดรูปแบบจะประกอบด้วยคอมโพเนนต์ที่อยู่อย่างน้อย 1 รายการตามหลักตรรกะ เช่น ที่อยู่ "111 8th Avenue, New York, NY" ประกอบด้วยคอมโพเนนต์ต่อไปนี้ "111" (เลขที่ถนน) "8th Avenue" (เส้นทาง) "New York" (เมือง) และ "NY" (รัฐในสหรัฐอเมริกา)
อย่าแยกวิเคราะห์ที่อยู่ซึ่งจัดรูปแบบแล้วแบบเป็นโปรแกรม แต่คุณควรใช้คอมโพเนนต์ที่อยู่แต่ละรายการ ซึ่งการตอบกลับจาก API จะรวมไว้นอกเหนือจากช่องที่อยู่ที่จัดรูปแบบแล้ว
address_components[]คืออาร์เรย์ที่มีคอมโพเนนต์แยกต่างหากที่ใช้กับที่อยู่นี้โดยทั่วไปแล้ว คอมโพเนนต์ที่อยู่แต่ละรายการจะมีช่องต่อไปนี้
types[]คืออาร์เรย์ที่ระบุประเภทขององค์ประกอบที่อยู่ องค์ประกอบที่อยู่อาจมีอาร์เรย์ประเภทที่ว่างเปล่าเมื่อไม่มีประเภทที่รู้จักสำหรับองค์ประกอบที่อยู่นั้น API อาจเพิ่มค่าประเภทใหม่ตามความจำเป็น ดูข้อมูลเพิ่มเติมได้ที่ประเภทที่อยู่และประเภทองค์ประกอบที่อยู่long_nameคือคำอธิบายข้อความแบบเต็มหรือชื่อของคอมโพเนนต์ที่อยู่ตามที่โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์แสดงผลshort_nameคือชื่อแบบย่อขององค์ประกอบที่อยู่ (หากมี) ตัวอย่างเช่น คอมโพเนนต์ที่อยู่สำหรับรัฐอลาสกาอาจมีlong_nameเป็น "Alaska" และshort_nameเป็น "AK" โดยใช้ตัวย่อไปรษณีย์ 2 ตัวอักษร
โปรดทราบข้อเท็จจริงต่อไปนี้เกี่ยวกับอาร์เรย์
address_components[]- อาร์เรย์ของคอมโพเนนต์ที่อยู่อาจมีคอมโพเนนต์มากกว่า
formatted_address - อาร์เรย์ไม่จำเป็นต้องรวมหน่วยงานทางการเมืองทั้งหมดที่มีที่อยู่ นอกเหนือจากหน่วยงานที่รวมอยู่ใน
formatted_addressหากต้องการดึงข้อมูลหน่วยงานทางการเมืองทั้งหมดที่มีที่อยู่เฉพาะ คุณควรใช้การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ โดยส่งละติจูด/ลองจิจูดของที่อยู่เป็นพารามิเตอร์ในคำขอ - รูปแบบการตอบกลับอาจเปลี่ยนแปลงได้ระหว่างคำขอ โดยเฉพาะอย่างยิ่ง จำนวน
address_componentsจะแตกต่างกันไปตามที่อยู่ที่ขอ และอาจเปลี่ยนแปลงเมื่อเวลาผ่านไปสำหรับที่อยู่เดียวกัน คอมโพเนนต์สามารถเปลี่ยนตำแหน่งในอาร์เรย์ได้ ประเภทของคอมโพเนนต์อาจเปลี่ยนแปลงได้ คอมโพเนนต์บางอย่างอาจหายไปในการตอบกลับในภายหลัง
หากต้องการจัดการอาร์เรย์ของคอมโพเนนต์ คุณควรแยกวิเคราะห์การตอบกลับและเลือกค่าที่เหมาะสมผ่านนิพจน์ ดูคำแนะนำเกี่ยวกับ การแยกวิเคราะห์การตอบกลับ
postcode_localities[]คืออาร์เรย์ที่แสดงถึงท้องถิ่นสูงสุด 100 แห่งที่อยู่ในรหัสไปรษณีย์ ข้อมูลนี้จะปรากฏเมื่อผลลัพธ์เป็นรหัสไปรษณีย์ที่มีหลายท้องถิ่นเท่านั้นgeometryมีข้อมูลต่อไปนี้locationมีค่าละติจูดและลองจิจูดที่เข้ารหัสพิกัดภูมิศาสตร์ สำหรับการค้นหาที่อยู่ปกติ ช่องนี้มักจะสำคัญที่สุดlocation_typeจะจัดเก็บข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ตั้งที่ระบุ ปัจจุบันระบบรองรับค่าต่อไปนี้"ROOFTOP"บ่งชี้ว่าผลลัพธ์ที่แสดงผลเป็นรหัสพิกัดภูมิศาสตร์ที่แน่นอนซึ่งเรามีข้อมูลตำแหน่งที่แม่นยำถึงระดับที่อยู่ถนน"RANGE_INTERPOLATED"บ่งบอกว่าผลลัพธ์ที่แสดงเป็นค่าประมาณ (โดยปกติจะอยู่บนถนน) ที่ประมาณค่าในช่วงระหว่างจุดที่แน่นอน 2 จุด (เช่น ทางแยก) โดยทั่วไปแล้ว ระบบจะแสดงผลลัพธ์ที่ประมาณค่าในช่วงเมื่อไม่มีรหัสพิกัดภูมิศาสตร์ระดับหลังคาสำหรับที่อยู่"GEOMETRIC_CENTER"บ่งบอกว่าผลลัพธ์ที่แสดงเป็นศูนย์กลางทางเรขาคณิตของผลลัพธ์ เช่น เส้นประกอบ (เช่น ถนน) หรือรูปหลายเหลี่ยม (ภูมิภาค)"APPROXIMATE"บ่งบอกว่าผลลัพธ์ที่แสดงเป็นค่าประมาณ
viewportมีวิวพอร์ตที่แนะนำสำหรับการแสดงผลลัพธ์ที่แสดงผล ซึ่งระบุเป็นค่าละติจูดและลองจิจูด 2 ค่าที่กำหนดมุมsouthwestและnortheastของกรอบล้อมรอบวิวพอร์ต โดยทั่วไปแล้ววิวพอร์ตจะใช้เพื่อจัดเฟรมผลลัพธ์เมื่อแสดงต่อผู้ใช้bounds(แสดงผลหรือไม่ก็ได้) จัดเก็บกรอบล้อมรอบซึ่งมีผลลัพธ์ที่แสดงผลทั้งหมดได้ โปรดทราบว่าขอบเขตเหล่านี้อาจไม่ตรงกับวิวพอร์ตที่แนะนำ (เช่น ซานฟรานซิสโกรวมหมู่เกาะฟารัลลอน ซึ่งในทางเทคนิคเป็นส่วนหนึ่งของเมือง แต่ไม่ควรแสดงในวิวพอร์ต)
-
plus_code(ดูรหัสตำแหน่งแบบเปิดและ Plus Codes) คือการอ้างอิงตำแหน่งที่เข้ารหัส ซึ่งได้มาจากพิกัดละติจูดและลองจิจูดที่แสดงพื้นที่ 1/8000 ขององศา คูณ 1/8000 ขององศา (ประมาณ 14 ม. x 14 ม. ที่เส้นศูนย์สูตร) หรือเล็กกว่านั้น Plus Codes สามารถใช้แทนที่อยู่ได้ในสถานที่ที่ไม่มีที่อยู่ (อาคารไม่มีเลขที่หรือถนนไม่มีชื่อ) API ไม่ได้แสดงผล Plus Code เสมอไปเมื่อบริการแสดงผล Plus Code ระบบจะจัดรูปแบบเป็นรหัสสากลและรหัสผสม ดังนี้
global_codeคือรหัสพื้นที่ 4 หลักและรหัสท้องถิ่น 6 หลักขึ้นไป (849VCWC8+R9)compound_codeคือรหัสท้องถิ่น 6 หลักขึ้นไปที่มีการระบุตำแหน่งชัดเจน (CWC8+R9, Mountain View, CA, USA) อย่าแยกวิเคราะห์เนื้อหานี้แบบเป็นโปรแกรม
-
partial_matchบ่งชี้ว่าโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ไม่ได้แสดงผลลัพธ์ที่ตรงทั้งหมดกับคำขอเดิม แม้ว่าจะสามารถจับคู่ส่วนหนึ่งของที่อยู่ที่ขอได้ก็ตาม คุณอาจต้องตรวจสอบคำขอเดิมเพื่อหาการสะกดผิดและ/หรือที่อยู่ที่ไม่สมบูรณ์การจับคู่บางส่วนมักเกิดขึ้นกับที่อยู่ซึ่งไม่มีอยู่จริงในท้องถิ่นที่คุณส่งมาในคำขอ ระบบอาจแสดงผลการจับคู่บางส่วนด้วยเมื่อคำขอตรงกับสถานที่ตั้ง 2 แห่งขึ้นไปในท้องถิ่นเดียวกัน เช่น "Hillpar St, Bristol, UK" จะแสดงผลการจับคู่บางส่วนสำหรับทั้ง Henry Street และ Henrietta Street โปรดทราบว่าหากคำขอมีคอมโพเนนต์ที่อยู่ซึ่งสะกดผิด บริการเข้ารหัสพิกัดภูมิศาสตร์อาจแนะนำที่อยู่อื่น คำแนะนำที่เรียกใช้ด้วยวิธีนี้จะได้รับการทำเครื่องหมายว่าตรงกันบางส่วนด้วย
place_idเป็นตัวระบุที่ไม่ซ้ำกันซึ่งใช้กับ Google APIs อื่นๆ ได้ ตัวอย่างเช่น คุณสามารถใช้place_idในคำขอ Places API เพื่อดูรายละเอียดของธุรกิจในพื้นที่ เช่น หมายเลขโทรศัพท์ เวลาทำการ รีวิวจากผู้ใช้ และอื่นๆ ดูภาพรวมรหัสสถานที่
ประเภทที่อยู่และประเภทคอมโพเนนต์ที่อยู่
อาร์เรย์ types ในการตอบกลับจะระบุประเภทที่อยู่ ตัวอย่างประเภทที่อยู่ ได้แก่ ที่อยู่ตามท้องถนน ประเทศ หรือหน่วยงานทางการเมือง อาร์เรย์ types ในช่อง address_component จะระบุประเภทของแต่ละส่วนของที่อยู่ ตัวอย่างเช่น หมายเลขถนนหรือประเทศ
ที่อยู่อาจมีได้หลายประเภท ประเภทอาจถือเป็น "แท็ก"
ตัวอย่างเช่น เมืองหลายแห่งมีการติดแท็กด้วยประเภท political และ locality
ระบบรองรับประเภทต่อไปนี้และแสดงผลทั้งในอาร์เรย์ประเภทที่อยู่และอาร์เรย์ประเภทคอมโพเนนต์ที่อยู่
| ประเภทที่อยู่ | คำอธิบาย |
|---|---|
street_address |
ที่อยู่ที่แน่นอน |
route |
เส้นทางที่มีชื่อ (เช่น "US 101") |
intersection |
ทางแยกหลัก ซึ่งมักเป็นทางแยกของถนนสายหลัก 2 สาย |
political |
บุคคลทางการเมือง โดยปกติแล้ว ประเภทนี้จะระบุรูปหลายเหลี่ยมของการปกครองพลเรือนบางประเภท |
country |
หน่วยงานทางการเมืองระดับชาติ และโดยทั่วไปจะเป็นประเภทลำดับสูงสุดที่โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์แสดงผล |
administrative_area_level_1 |
หน่วยงานพลเรือนระดับที่ 1 ที่ต่ำกว่าระดับประเทศ ในสหรัฐอเมริกา การบริหารระดับเหล่านี้คือรัฐ บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ ในกรณีส่วนใหญ่ ชื่อย่อของ administrative_area_level_1 จะตรงกับเขตการปกครองย่อยตามมาตรฐาน ISO 3166-2 และรายการอื่นๆ ที่ใช้กันอย่างแพร่หลาย อย่างไรก็ตาม เราไม่รับประกันว่าจะเป็นเช่นนี้เสมอไป เนื่องจากผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์ของเราอิงตามสัญญาณและข้อมูลตำแหน่งที่หลากหลาย |
administrative_area_level_2 |
หน่วยงานพลเรือนระดับที่ 2 ที่ต่ำกว่าระดับประเทศ ในสหรัฐอเมริกา การบริหารระดับเหล่านี้คือระดับเคาน์ตี บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ |
administrative_area_level_3 |
หน่วยงานพลเรือนระดับที่ 3 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ |
administrative_area_level_4 |
หน่วยงานพลเรือนระดับที่ 4 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ |
administrative_area_level_5 |
หน่วยงานพลเรือนระดับที่ 5 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ |
administrative_area_level_6 |
หน่วยงานพลเรือนระดับที่ 6 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ |
administrative_area_level_7 |
หน่วยงานพลเรือนระดับที่ 7 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ |
colloquial_area |
ชื่ออื่นที่ใช้กันโดยทั่วไปสำหรับเอนทิตี |
locality |
หน่วยงานทางการเมืองของเมืองหรือเทศบาลที่จัดตั้งขึ้น |
sublocality |
หน่วยงานพลเรือนระดับที่ 1 ที่ต่ำกว่าระดับท้องถิ่น สถานที่บางแห่งอาจได้รับประเภทเพิ่มเติมอย่างใดอย่างหนึ่งต่อไปนี้ sublocality_level_1 ถึง sublocality_level_5 ระดับท้องถิ่นย่อยแต่ละระดับเป็นหน่วยงานพลเรือน ตัวเลขที่มากขึ้นจะแสดงถึงพื้นที่ทางภูมิศาสตร์ที่เล็กลง |
neighborhood |
ย่านที่มีชื่อ |
premise |
สถานที่ที่มีชื่อ โดยปกติจะเป็นอาคารหรือกลุ่มอาคารที่มีชื่อร่วมกัน |
subpremise |
เอนทิตีที่ระบุที่อยู่ได้ซึ่งอยู่ต่ำกว่าระดับสถานที่ตั้ง เช่น อพาร์ตเมนต์ ยูนิต หรือห้องชุด |
plus_code |
การอ้างอิงตำแหน่งที่เข้ารหัส ซึ่งได้มาจากละติจูดและลองจิจูด Plus Code สามารถใช้แทนที่อยู่บนถนนในสถานที่ที่ไม่มีที่อยู่ (อาคารที่ไม่มีหมายเลขหรือถนนที่ไม่มีชื่อ) ดูรายละเอียดได้ที่ https://plus.codes |
postal_code |
รหัสไปรษณีย์ที่ใช้ในการจ่าหน้าจดหมายภายในประเทศ |
natural_feature |
สถานที่ทางธรรมชาติที่โดดเด่น |
airport |
สนามบิน |
park |
สวนสาธารณะที่มีชื่อ |
point_of_interest |
จุดที่น่าสนใจที่มีชื่อ โดยปกติแล้ว "POI" เหล่านี้จะเป็นสถานที่โดดเด่นในท้องถิ่นซึ่งไม่เข้ากับหมวดหมู่อื่นๆ เช่น "ตึกเอ็มไพร์สเตต" หรือ "หอไอเฟล" |
รายการประเภทที่ว่างเปล่าบ่งชี้ว่าไม่มีประเภทที่รู้จักสำหรับองค์ประกอบที่อยู่หนึ่งๆ (เช่น Lieu-dit ในฝรั่งเศส)
นอกจากข้อมูลข้างต้นแล้ว คอมโพเนนต์ที่อยู่อาจรวมถึงประเภทที่ระบุไว้ด้านล่างด้วย
| ประเภทองค์ประกอบที่อยู่ | คำอธิบาย |
|---|---|
floor |
ชั้นของที่อยู่อาคาร |
establishment |
โดยปกติแล้วจะเป็นสถานที่ที่ยังไม่ได้จัดหมวดหมู่ |
landmark |
สถานที่ใกล้เคียงที่ใช้เป็นข้อมูลอ้างอิงเพื่อช่วยในการนำทาง |
point_of_interest |
จุดที่น่าสนใจที่มีชื่อ |
parking |
ที่จอดรถหรืออาคารจอดรถ |
post_box |
ตู้ไปรษณีย์ที่เฉพาะเจาะจง |
postal_town |
การจัดกลุ่มพื้นที่ทางภูมิศาสตร์ เช่น locality และ sublocality ซึ่งใช้สำหรับที่อยู่จัดส่งในบางประเทศ |
room |
ห้องของที่อยู่อาคาร |
street_number |
เลขที่ถนนที่แน่นอน |
bus_station, train_station และ transit_station |
ตำแหน่งของป้ายรถประจำทาง สถานีรถไฟ หรือป้ายรถขนส่งสาธารณะ |
การให้น้ำหนักวิวพอร์ต
ในคำขอการเข้ารหัสพิกัดภูมิศาสตร์ คุณสามารถสั่งให้บริการเข้ารหัสพิกัดภูมิศาสตร์แสดงผลลัพธ์ภายในวิวพอร์ตที่ระบุ (แสดงเป็นกรอบล้อมรอบ) โดยตั้งค่าพารามิเตอร์ bounds ภายใน URL คำขอ
พารามิเตอร์ bounds จะกำหนดพิกัดละติจูด/ลองจิจูดของมุมตะวันตกเฉียงใต้และตะวันออกเฉียงเหนือของกรอบล้อมรอบนี้โดยใช้อักขระไปป์ (|) เพื่อแยกพิกัด
ตัวอย่างเช่น รหัสพิกัดภูมิศาสตร์สำหรับ "Washington" โดยทั่วไปจะแสดงผลลัพธ์เป็นรัฐวอชิงตันของสหรัฐอเมริกา
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?address=Washington&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Washington",
"short_name" : "WA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Washington, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 49.0024442,
"lng" : -116.91558
},
"southwest" : {
"lat" : 45.543541,
"lng" : -124.8489739
}
},
"location" : {
"lat" : 47.7510741,
"lng" : -120.7401385
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 49.0024442,
"lng" : -116.91558
},
"southwest" : {
"lat" : 45.543541,
"lng" : -124.8489739
}
}
},
"place_id" : "ChIJ-bDD5__lhVQRuvNfbGh4QpQ",
"types" : [ "administrative_area_level_1", "political" ]
}
],
"status" : "OK"
}
อย่างไรก็ตาม การเพิ่มอาร์กิวเมนต์ bounds ที่กำหนดกรอบล้อมรอบส่วนตะวันออกเฉียงเหนือของสหรัฐอเมริกาจะทำให้รหัสพิกัดภูมิศาสตร์นี้แสดงผลกรุงวอชิงตัน ดี.ซี.
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?address=Washington&bounds=36.47,-84.72%7C43.39,-65.90&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Washington",
"short_name" : "Washington",
"types" : [ "locality", "political" ]
},
{
"long_name" : "District of Columbia",
"short_name" : "District of Columbia",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "District of Columbia",
"short_name" : "DC",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Washington, DC, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 38.9958641,
"lng" : -76.90939299999999
},
"southwest" : {
"lat" : 38.7916449,
"lng" : -77.119759
}
},
"location" : {
"lat" : 38.9071923,
"lng" : -77.03687069999999
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 38.9958641,
"lng" : -76.90939299999999
},
"southwest" : {
"lat" : 38.7916449,
"lng" : -77.119759
}
}
},
"place_id" : "ChIJW-T2Wt7Gt4kRKl2I1CJFUsI",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
การให้น้ำหนักพิเศษกับบางภูมิภาค
ในการร้องขอการเข้ารหัสพิกัดภูมิศาสตร์ คุณสามารถสั่งให้บริการเข้ารหัสพิกัดภูมิศาสตร์แสดงผลลัพธ์ที่ให้น้ำหนักไปทางภูมิภาคใดภูมิภาคหนึ่งโดยเฉพาะได้ โดยใช้พารามิเตอร์ region พารามิเตอร์นี้จะใช้อาร์กิวเมนต์ ccTLD (โดเมนระดับบนสุดแบบรหัสประเทศ) ที่ระบุการให้น้ำหนักพิเศษกับบางภูมิภาค รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคลของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
ผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์อาจให้น้ำหนักกับทุกโดเมนที่มีการเปิดตัวแอปพลิเคชัน Google Maps หลักอย่างเป็นทางการ โปรดทราบว่าการให้น้ำหนักพิเศษจะเลือกผลการค้นหาสำหรับโดเมนที่เฉพาะเจาะจงเท่านั้น หากมีผลการค้นหาที่เกี่ยวข้องมากกว่านอกโดเมนนี้ ระบบอาจรวมผลการค้นหาเหล่านั้นด้วย
ตัวอย่างเช่น รหัสพิกัดภูมิศาสตร์สำหรับ "Toledo" จะแสดงผลลัพธ์นี้ เนื่องจากโดเมนเริ่มต้นสำหรับ Geocoding API ตั้งค่าเป็นสหรัฐอเมริกา คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?address=Toledo&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Toledo",
"short_name" : "Toledo",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Lucas County",
"short_name" : "Lucas County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Ohio",
"short_name" : "OH",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, OH, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 41.732844,
"lng" : -83.454229
},
"southwest" : {
"lat" : 41.580266,
"lng" : -83.69423700000002
}
},
"location" : {
"lat" : 41.6639383,
"lng" : -83.55521200000001
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 41.732844,
"lng" : -83.454229
},
"southwest" : {
"lat" : 41.580266,
"lng" : -83.69423700000002
}
}
},
"place_id" : "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
คำขอการเข้ารหัสพิกัดภูมิศาสตร์สำหรับ "Toledo" ที่มี region=es (สเปน) จะแสดงผลลัพธ์เป็นเมืองในสเปน
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?address=Toledo®ion=es&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Toledo",
"short_name" : "Toledo",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Toledo",
"short_name" : "TO",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Castile-La Mancha",
"short_name" : "CM",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Spain",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, Spain",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 39.88605099999999,
"lng" : -3.9192423
},
"southwest" : {
"lat" : 39.8383676,
"lng" : -4.0796176
}
},
"location" : {
"lat" : 39.8628316,
"lng" : -4.027323099999999
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 39.88605099999999,
"lng" : -3.9192423
},
"southwest" : {
"lat" : 39.8383676,
"lng" : -4.0796176
}
}
},
"place_id" : "ChIJ8f21C60Lag0R_q11auhbf8Y",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
การกรองคอมโพเนนต์
ในการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ Geocoding API สามารถแสดงผลลัพธ์ที่อยู่ซึ่งจำกัดไว้เฉพาะพื้นที่ที่ระบุได้ คุณระบุข้อจำกัดได้โดยใช้ตัวกรอง components ตัวกรองประกอบด้วยรายการคู่ component:value ที่คั่นด้วยไปป์ (|) ค่าตัวกรองรองรับวิธีการแก้ไขการสะกดและการจับคู่บางส่วนเช่นเดียวกับคำขอการเข้ารหัสพิกัดภูมิศาสตร์อื่นๆ หากโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์พบการจับคู่บางส่วนสำหรับตัวกรองคอมโพเนนต์ การตอบกลับจะมีช่อง partial_match
components ที่กรองได้มีดังนี้
postal_codeตรงกับpostal_codeและpostal_code_prefixcountryตรงกับชื่อประเทศหรือรหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO 3166-1 API เป็นไปตามมาตรฐาน ISO สำหรับการกำหนดประเทศ และการกรองจะทำงานได้ดีที่สุดเมื่อใช้รหัส ISO ที่เกี่ยวข้องของประเทศ
ระบบอาจใช้ components ต่อไปนี้เพื่อส่งผลต่อผลลัพธ์ แต่จะไม่บังคับใช้
routeตรงกับชื่อแบบยาวหรือชื่อย่อของเส้นทางlocalityตรงกับประเภทlocalityและsublocalityadministrative_areaตรงกับระดับadministrative_areaทั้งหมด
หมายเหตุเกี่ยวกับการกรองคอมโพเนนต์
- อย่าใช้ตัวกรองคอมโพเนนต์เหล่านี้ซ้ำในคำขอ ไม่เช่นนั้น API จะแสดงผล
Invalid_request:country,postal_code,route - หากคำขอมีตัวกรองคอมโพเนนต์ซ้ำกัน API จะประเมินตัวกรองเหล่านั้นเป็น AND ไม่ใช่ OR
- ผลลัพธ์จะสอดคล้องกับ Google Maps ซึ่งบางครั้งอาจให้การตอบสนอง
ZERO_RESULTSที่ไม่คาดคิด การใช้ Place Autocomplete อาจให้ผลลัพธ์ที่ดีกว่าในบางกรณีการใช้งาน ดูข้อมูลเพิ่มเติมได้ที่คำถามที่พบบ่อยนี้ - สำหรับคอมโพเนนต์ที่อยู่แต่ละรายการ ให้ระบุในพารามิเตอร์
addressหรือในตัวกรองcomponentsอย่างใดอย่างหนึ่ง แต่ไม่ใช่ทั้ง 2 อย่าง การระบุค่าเดียวกันในทั้ง 2 รายการอาจส่งผลให้เกิดZERO_RESULTS
รหัสพิกัดภูมิศาสตร์สำหรับ "High St, Hastings" ที่มี components=country:GB จะแสดงผลลัพธ์ในเมืองเฮสติงส์ ประเทศอังกฤษ แทนที่จะเป็นเมืองเฮสติงส์-ออน-ฮัดสัน สหรัฐอเมริกา
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?address=high+st+hasting&components=country:GB&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "High Street",
"short_name" : "High St",
"types" : [ "route" ]
},
{
"long_name" : "Hastings",
"short_name" : "Hastings",
"types" : [ "postal_town" ]
},
{
"long_name" : "East Sussex",
"short_name" : "East Sussex",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "England",
"short_name" : "England",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United Kingdom",
"short_name" : "GB",
"types" : [ "country", "political" ]
},
{
"long_name" : "TN34 3EY",
"short_name" : "TN34 3EY",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "High St, Hastings TN34 3EY, UK",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 50.8601041,
"lng" : 0.5957329
},
"southwest" : {
"lat" : 50.8559061,
"lng" : 0.5906163
}
},
"location" : {
"lat" : 50.85830319999999,
"lng" : 0.5924594
},
"location_type" : "GEOMETRIC_CENTER",
"viewport" : {
"northeast" : {
"lat" : 50.8601041,
"lng" : 0.5957329
},
"southwest" : {
"lat" : 50.8559061,
"lng" : 0.5906163
}
}
},
"partial_match" : true,
"place_id" : "ChIJ-Ws929sa30cRKgsMNVkPyws",
"types" : [ "route" ]
}
],
"status" : "OK"
}
คำขอรหัสพิกัดภูมิศาสตร์สำหรับท้องถิ่น "Santa Cruz" ที่มี components=country:ES จะแสดงผลลัพธ์เป็นซานตากรุซเดเตเนริเฟในหมู่เกาะคะแนรี ประเทศสเปน
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?components=locality:santa+cruz|country:ES&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Santa Cruz de Tenerife",
"short_name" : "Santa Cruz de Tenerife",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Santa Cruz de Tenerife",
"short_name" : "TF",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Canary Islands",
"short_name" : "CN",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Spain",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Santa Cruz de Tenerife, Spain",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 28.487616,
"lng" : -16.2356646
},
"southwest" : {
"lat" : 28.4280248,
"lng" : -16.3370045
}
},
"location" : {
"lat" : 28.4636296,
"lng" : -16.2518467
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 28.487616,
"lng" : -16.2356646
},
"southwest" : {
"lat" : 28.4280248,
"lng" : -16.3370045
}
}
},
"place_id" : "ChIJcUElzOzMQQwRLuV30nMUEUM",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
การกรองคอมโพเนนต์จะแสดงผลลัพธ์ ZERO_RESULTS เฉพาะในกรณีที่คุณระบุตัวกรองที่แยกออกจากกัน
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?components=administrative_area:TX|country:FR&key=YOUR_API_KEY
คำตอบ:
{
"results" : [],
"status" : "ZERO_RESULTS"
}
คุณสามารถทำการค้นหาที่ถูกต้องได้โดยไม่ต้องใช้พารามิเตอร์ที่อยู่ โดยใช้ตัวกรอง components (เมื่อเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่แบบเต็ม คุณต้องระบุพารามิเตอร์ address หากคำขอมีชื่อและหมายเลขของอาคาร)
คำขอ:
https://maps.googleapis.com/maps/api/geocode/json?components=route:Annankatu|administrative_area:Helsinki|country:Finland&key=YOUR_API_KEY
คำตอบ:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Annankatu",
"short_name" : "Annankatu",
"types" : [ "route" ]
},
{
"long_name" : "Helsinki",
"short_name" : "HKI",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Finland",
"short_name" : "FI",
"types" : [ "country", "political" ]
},
{
"long_name" : "00101",
"short_name" : "00101",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "Annankatu, 00101 Helsinki, Finland",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 60.168997,
"lng" : 24.9433353
},
"southwest" : {
"lat" : 60.16226160000001,
"lng" : 24.9332897
}
},
"location" : {
"lat" : 60.1657808,
"lng" : 24.938451
},
"location_type" : "GEOMETRIC_CENTER",
"viewport" : {
"northeast" : {
"lat" : 60.168997,
"lng" : 24.9433353
},
"southwest" : {
"lat" : 60.16226160000001,
"lng" : 24.9332897
}
}
},
"place_id" : "ChIJARW7C8sLkkYRgl4je4-RPUM",
"types" : [ "route" ]
}
],
"status" : "OK"
}