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

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

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

เพิ่มบริการ Places และ Geocoding ใน Maps SDK สำหรับแอป Android ในลักษณะต่อไปนี้

  • Places SDK สำหรับ Android เป็นไลบรารี Android ที่มีวิธีการส่งคืนข้อมูลเกี่ยวกับ สถานที่
  • Places API จะแสดงข้อมูลเกี่ยวกับสถานที่ต่างๆ โดยใช้คำขอ HTTP
  • คลาสตัวเข้ารหัสพิกัดภูมิศาสตร์ สามารถใส่รหัสพิกัดภูมิศาสตร์และกลับรหัสพิกัดภูมิศาสตร์แบบไดนามิกจากข้อมูลที่ผู้ใช้ป้อนได้
  • 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'

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

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

ดูรายละเอียดสถานที่ของแต่ละภูมิภาค

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

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

ใช้ Geocoding API

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

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

ตัวอย่างต่อไปนี้ใช้ที่อยู่ (URL - Escape) เพื่อส่งคำขอไปยัง 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