ภาพรวม Geocoding API

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

Geocoding API เป็นบริการที่ยอมรับสถานที่ในรูปแบบที่อยู่ พิกัดละติจูดและลองจิจูด หรือรหัสสถานที่ โดยจะแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูดและรหัสสถานที่ หรือแปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ให้เป็นที่อยู่

สิ่งที่คุณทำได้ด้วย Geocoding API

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

  • พิกัดทางภูมิศาสตร์สำหรับที่อยู่
  • ที่อยู่สำหรับชุดพิกัดละติจูดและลองจิจูด
  • ที่อยู่สำหรับรหัสสถานที่

คุณควบคุมตำแหน่งที่ผลการค้นหาจะปรากฏและจำกัดผลการค้นหาให้อยู่ในภูมิภาค เขต หรือรหัสไปรษณีย์ที่เฉพาะเจาะจงได้

วิธีการทำงานของ Geocoding API

Geocoding API ทำทั้งการเข้ารหัสพิกัดภูมิศาสตร์และการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ ดังนี้

  • การเข้ารหัสพิกัดภูมิศาสตร์: แปลงที่อยู่ เช่น "1600 Amphitheatre Parkway, Mountain View, CA" เป็นพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ คุณสามารถใช้พิกัดเหล่านี้เพื่อวางเครื่องหมายบนแผนที่ หรือเพื่อจัดกึ่งกลางหรือเปลี่ยนตำแหน่งแผนที่ภายในเฟรมมุมมอง
  • การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ: แปลงพิกัดละติจูด/ลองจิจูดหรือรหัสสถานที่ให้เป็นที่อยู่ที่มนุษย์อ่านได้ คุณสามารถใช้ที่อยู่สำหรับสถานการณ์ต่างๆ ได้ เช่น การนำส่งหรือการรับสินค้า

การสาธิตต่อไปนี้ใช้บริการการเข้ารหัสพิกัดภูมิศาสตร์ผ่าน Maps JavaScript API เพื่อสาธิตวิธีการทำงานของ Geocoding API เปิดแผนที่ในแท็บแยกต่างหากเพื่อดูตัวเลือกและรายละเอียดเพิ่มเติม

แหล่งข้อมูล

ตารางต่อไปนี้สรุปแหล่งข้อมูลที่พร้อมใช้งานผ่าน Geocoding API พร้อมกับข้อมูลที่แต่ละเมธอดแสดงผล

แหล่งข้อมูล ข้อมูลที่แสดงผล รูปแบบการคืนสินค้า
การเข้ารหัสพิกัดภูมิศาสตร์ แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูผลลัพธ์ในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์
  • JSON
  • XML
การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่

วิธีใช้ Geocoding API

1 ตั้งค่าเลย เริ่มต้นด้วยการตั้งค่าโปรเจ็กต์ Google Cloud และทำตามวิธีการตั้งค่าที่ตามมาให้เสร็จสมบูรณ์
2 ลองส่งคำขอการเข้ารหัสพิกัดภูมิศาสตร์ เมื่อมีคีย์ API แล้ว คุณจะเริ่มทดสอบ Geocoding API ได้โดยตรงจาก curl หรือเบราว์เซอร์ คุณจะต้องระบุพารามิเตอร์การค้นหาที่ถูกต้องสำหรับการค้นหาที่อยู่หรือคอมโพเนนต์ ดูรายละเอียดได้ที่พารามิเตอร์การเข้ารหัสพิกัดภูมิศาสตร์
3 ลองส่งคำขอการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ ระบุพิกัดละติจูด/ลองจิจูดพร้อมกับคีย์ API เพื่อรับคอมโพเนนต์ที่อยู่สำหรับที่อยู่ที่มนุษย์อ่านได้ซึ่งใกล้เคียงที่สุดสำหรับสถานที่นั้น ดูรายละเอียดได้ที่คำขอการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
4 ทำความเข้าใจข้อมูลพื้นฐานเกี่ยวกับการตอบกลับ เมธอดทั้งหมดใน Geocoding API จะแสดงข้อมูลเดียวกันในรูปแบบ JSON หรือ XML ดูคำอธิบายข้อมูล รหัสสถานะ และข้อความแสดงข้อผิดพลาดได้ที่การตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์
5 รวมข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์ไว้ในแอปของคุณเอง คุณสามารถใช้ข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์เพื่อรับที่อยู่จากเครื่องหมายบนแผนที่ หรือเพื่อระบุเครื่องหมายบนแผนที่ตามที่อยู่ที่ทราบ

ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน

เรียก API นี้ในภาษาที่คุณเลือกผ่านไลบรารีของไคลเอ็นต์รายการใดรายการหนึ่งต่อไปนี้

ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, ไคลเอ็นต์ Go และไคลเอ็นต์ Node.js สำหรับบริการ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่ชุมชนรองรับ ซึ่งเป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดไลบรารีจาก GitHub ซึ่งคุณจะดูวิธีการติดตั้งและโค้ดตัวอย่างได้ด้วย

ขั้นตอนถัดไป