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

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

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

เพิ่มบริการ Places และ Geocoding ลงใน Maps SDK สำหรับแอป Android โดยทำดังนี้

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

ใช้บริการ Places

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

คุณสามารถใช้ Text Search (ใหม่) 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 ช่วยให้ผู้ใช้ค้นหาภูมิภาคได้อย่างสะดวก หากต้องการกำหนดค่าบริการการเติมข้อความอัตโนมัติของ Places ให้ แสดงเฉพาะภูมิภาค ให้ใช้ AutocompleteSupportFragment.setTypesFilter(List) เพื่อตั้งค่าตัวกรองประเภทเป็น PlaceTypes.REGIONS

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

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

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

ใช้ Geocoding API

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

  • ใช้ Geocoding เพื่อรับ Viewport สำหรับภูมิภาค
  • ใช้การกรองคอมโพเนนต์กับการเรียก Geocoding เพื่อรับรหัสสถานที่สำหรับ เขตการปกครอง 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 โดยเพิ่มข้อจำกัดของคอมโพเนนต์ด้วย Geocoding แบบย้อนกลับเพื่อรับคอมโพเนนต์ที่อยู่ทั้งหมดในตำแหน่งที่ระบุสำหรับประเภท locality เท่านั้น

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