ใช้บริการ Places และ Geocoding API กับการกำหนดสไตล์ตามข้อมูลที่ขับเคลื่อนโดยข้อมูลสำหรับขอบเขต

เลือกแพลตฟอร์ม: Android iOS JavaScript

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

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

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

ใช้บริการ Places

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

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

ตัวอย่างเช่น หากต้องการรับรหัสสถานที่สำหรับตรินิแดด แคลิฟอร์เนีย คุณสามารถเรียก 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'

ใช้ Place Autocomplete เพื่อค้นหาภูมิภาค

บริการPlace Autocompleteใน Places SDK สำหรับ Android ช่วยให้ผู้ใช้ค้นหาภูมิภาคได้อย่างสะดวก หากต้องการกำหนดค่าบริการ Place Autocomplete ให้แสดงผลเฉพาะภูมิภาค ให้ใช้ 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

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

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