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

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

เพิ่มบริการ Places และ Geocoding ใน 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

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

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