ใช้บริการ Places และ Geocoding API กับการจัดรูปแบบตามข้อมูลสำหรับขอบเขต

เลือกแพลตฟอร์ม แอนดรอยด์ iOS JavaScript

คุณสามารถใช้บริการ Places และ Geocoding API กับ Maps SDK สําหรับ Android เพื่อค้นหาภูมิภาคและดูข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ได้ บริการ Places และ Geocoding API เป็นทางเลือกที่มีประสิทธิภาพและเสถียรสำหรับการรับรหัสสถานที่ หากใช้รหัสสถานที่อยู่แล้ว คุณสามารถนำรหัสเหล่านั้นมาใช้ซ้ำกับการจัดสไตล์ตามข้อมูลที่ขับเคลื่อนขอบเขตได้

เพิ่มบริการ Places และการแปลงพิกัดภูมิศาสตร์ลงในแอป Maps SDK สําหรับ Android ของคุณด้วยวิธีต่อไปนี้

  • Places SDK สำหรับ Android เป็นไลบรารี Android ที่มีวิธีการส่งคืนข้อมูลเกี่ยวกับ สถานที่
  • Places API จะแสดงข้อมูลเกี่ยวกับสถานที่โดยใช้คำขอ HTTP
  • คลาสตัวเข้ารหัสพิกัดภูมิศาสตร์ สามารถใส่รหัสพิกัดภูมิศาสตร์และกลับรหัสพิกัดภูมิศาสตร์แบบไดนามิกจากข้อมูลที่ผู้ใช้ป้อนได้
  • Geocoding API ช่วยให้คุณเข้ารหัสพิกัดภูมิศาสตร์ที่อยู่แบบคงที่ซึ่งทราบอยู่แล้วได้

ใช้บริการ Places

ใช้การค้นหาข้อความ (ใหม่) เพื่อค้นหารหัสสถานที่

คุณสามารถใช้ Text Search (ใหม่) REST API ใน Places API เพื่อรับรหัสสถานที่ที่มีข้อมูลภูมิภาคโดยระบุ places.id ในมาสก์ฟิลด์ การใช้การค้นหาข้อความ (ใหม่) เพื่อขอรหัสสถานที่จะไม่มีค่าใช้จ่าย ดูข้อมูลเพิ่มเติม

เช่น หากต้องการรับรหัสสถานที่สำหรับเมือง Trinidad, CA ให้เรียกใช้ API ต่อไปนี้

curl -X POST -d '{
  "textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

ใช้การเติมข้อความอัตโนมัติของสถานที่เพื่อค้นหาภูมิภาค

การเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ ใน Places SDK สำหรับ Android มอบวิธีที่สะดวกในการ ผู้ใช้ค้นหาภูมิภาค หากต้องการกำหนดค่าบริการเติมข้อความอัตโนมัติใน Places แสดงผลเฉพาะภูมิภาค, ใช้ AutocompleteSupportFragment.setTypesFilter(List) เพื่อตั้งค่าตัวกรองประเภทเป็น PlaceTypes.REGIONS

ดูรายละเอียดสถานที่สำหรับภูมิภาค

บริการรายละเอียดสถานที่ใน Places SDK สําหรับ Android ที่แสดงผลข้อมูลสําหรับภูมิภาคหนึ่งๆ นั้นมีประโยชน์มาก ตัวอย่างเช่น คุณสามารถ

  • ค้นหารหัสสถานที่ที่เป็นขอบเขตตามชื่อสถานที่
  • รับวิวพอร์ตเพื่อซูมถึงขอบเขต
  • รับประเภทฟีเจอร์สําหรับขอบเขต (เช่น locality)
  • รับที่อยู่ที่มีการจัดรูปแบบ ซึ่งจะแสดงผลเป็น "ชื่อสถานที่ รัฐ ประเทศ" ในภูมิภาคสหรัฐอเมริกา (เช่น "Ottumwa, IA, USA")
  • รับข้อมูลที่เป็นประโยชน์อื่นๆ เช่น รูปภาพ

ใช้ Geocoding API

Geocoding API ช่วยให้คุณแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูด รวมถึงรหัสสถานที่ หรือแปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่เป็นที่อยู่ การใช้ต่อไปนี้เข้ากันได้ดีกับการจัดสไตล์ตามข้อมูลที่ขับเคลื่อนโดยข้อมูลสําหรับขอบเขต

  • ใช้การระบุพิกัดทางภูมิศาสตร์เพื่อรับวิวพอร์ตของภูมิภาค
  • ใช้การกรองคอมโพเนนต์กับการเรียกใช้การแปลงที่อยู่เป็นพิกัดภูมิศาสตร์เพื่อรับรหัสสถานที่สำหรับเขตบริหาร 1-4 เขตหรือรหัสไปรษณีย์
  • ใช้การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับเพื่อค้นหารหัสสถานที่ตามละติจูดและลองจิจูด หรือแม้แต่แสดงรหัสสถานที่ของทุกคอมโพเนนต์ใน ตำแหน่งนั้น

ตัวอย่างต่อไปนี้ใช้ที่อยู่ (URL ที่แปลงค่า) เพื่อส่งคำขอไปยัง Geocoding API

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

คุณสามารถใช้การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ เพื่อค้นหารหัสสถานที่ ตัวอย่างต่อไปนี้คือ Geocoding ฟังก์ชันบริการจะแสดงรหัสสถานที่สำหรับองค์ประกอบที่อยู่ทั้งหมดที่ พิกัดละติจูดและลองจิจูดที่ระบุ:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

ใช้การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับกับการกรองคอมโพเนนต์เพื่อรับคอมโพเนนต์ที่อยู่ สำหรับประเภทต่อไปนี้อย่างน้อย 1 ประเภทในตำแหน่งที่ระบุ

  • administrativeArea
  • country
  • locality
  • postalCode

ตัวอย่างฟังก์ชันถัดไปแสดงการใช้บริการการแปลงพิกัดภูมิศาสตร์ การเพิ่มข้อจำกัดขององค์ประกอบด้วยการแปลงภูมิศาสตร์ย้อนกลับเพื่อรับองค์ประกอบที่อยู่ทั้งหมดในตำแหน่งที่ระบุสำหรับประเภท locality เท่านั้น

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY