Geocoding API เป็นบริการที่ให้การเข้ารหัสพิกัดภูมิศาสตร์และการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับของที่อยู่
การแปลงพิกัดภูมิศาสตร์คือกระบวนการแปลงที่อยู่ (เช่น ที่อยู่) เป็นพิกัดทางภูมิศาสตร์ (เช่น ละติจูดและลองจิจูด) ซึ่งคุณใช้วางเครื่องหมายบนแผนที่หรือจัดตำแหน่งแผนที่ได้
การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับคือกระบวนการแปลงพิกัดทางภูมิศาสตร์เป็นที่อยู่ซึ่งมนุษย์อ่านได้
นอกจากนี้ คุณยังใช้ Geocoding API เพื่อค้นหาที่อยู่ของรหัสสถานที่ที่ระบุได้ด้วย
ตัวอย่างคำขอและการตอบกลับ
คุณเข้าถึง Geocoding API ผ่านอินเทอร์เฟซ HTTP ต่อไปนี้คือตัวอย่างคำขอการแปลงที่อยู่เป็นพิกัดภูมิศาสตร์และการแปลงพิกัดภูมิศาสตร์กลับ
คำขอและการตอบกลับการแปลงพิกัดภูมิศาสตร์ (การค้นหาละติจูด/ลองจิจูด)
ตัวอย่างต่อไปนี้ขอละติจูดและลองจิจูดของ "1600 Amphitheatre Parkway, Mountain View, CA" และระบุว่าเอาต์พุตต้องเป็นรูปแบบ JSON
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
คุณสามารถทดสอบได้โดยป้อน URL ลงในเว็บเบราว์เซอร์ (อย่าลืมแทนที่ YOUR_API_KEY ด้วยคีย์ API จริง)
การตอบกลับจะมีละติจูดและลองจิจูดของที่อยู่
ดูข้อมูลเพิ่มเติมเกี่ยวกับ การสร้าง URL คำขอการแปลงพิกัดภูมิศาสตร์และพารามิเตอร์ที่ใช้ได้ รวมถึง การทำความเข้าใจการตอบกลับได้ในคู่มือนักพัฒนาซอฟต์แวร์
ด้านล่างนี้คือตัวอย่างการตอบกลับการจับคู่พิกัดภูมิศาสตร์ในรูปแบบ JSON
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
คำขอและคำตอบสำหรับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ (การค้นหาที่อยู่)
ตัวอย่างต่อไปนี้ขอที่อยู่ซึ่งสอดคล้องกับละติจูด/ลองจิจูดที่ระบุในบรู๊กลิน นิวยอร์ก สหรัฐอเมริกา ซึ่งระบุว่าเอาต์พุตต้องอยู่ในรูปแบบ JSON
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYคุณสามารถทดสอบได้โดยป้อน URL ลงในเว็บเบราว์เซอร์ (อย่าลืมแทนที่ "YOUR_API_KEY" ด้วยคีย์ API จริง) การตอบกลับจะมีที่อยู่ตำแหน่งละติจูดและลองจิจูดที่มนุษย์อ่านได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับ การสร้าง URL คำขอการแปลงพิกัดภูมิศาสตร์ย้อนกลับและพารามิเตอร์ที่ใช้ได้ รวมถึง การทำความเข้าใจการตอบกลับได้ในคู่มือนักพัฒนาซอฟต์แวร์
ด้านล่างนี้คือตัวอย่างการตอบกลับการแปลงพิกัดภูมิศาสตร์ย้อนกลับในรูปแบบ JSON
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
เริ่มเขียนโค้ดด้วยไลบรารีของไคลเอ็นต์
ไลบรารีของไคลเอ็นต์ช่วยให้การพัฒนาด้วย API ของบริการเว็บ Google Maps ง่ายขึ้นด้วยการติดตั้งใช้งานแบบเนทีฟที่เรียบง่ายสำหรับงานทั่วไป เช่น การตรวจสอบสิทธิ์ การควบคุมปริมาณคำขอ และการลองอีกครั้งโดยอัตโนมัติ Geocoding API พร้อมให้บริการในไคลเอ็นต์ Java, ไคลเอ็นต์ Python, ไคลเอ็นต์ Go และไคลเอ็นต์ Node.js สำหรับบริการ Google Maps
การตรวจสอบสิทธิ์ โควต้า ราคา และนโยบาย
การตรวจสอบสิทธิ์
หากต้องการใช้ Geocoding API คุณต้องเปิดใช้ API ก่อน และรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ที่เหมาะสม โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเริ่มต้นใช้งาน Google Maps Platform
โควต้าและการกำหนดราคา
โปรดดูรายละเอียดเกี่ยวกับโควต้าและการกำหนดราคาสำหรับ Geocoding API ในหน้าการใช้งานและการเรียกเก็บเงิน
นโยบาย
การใช้ Geocoding API ต้องเป็นไปตามนโยบาย API
ดูข้อมูลเพิ่มเติม
คุณยังทําสิ่งอื่นๆ อีกมากมายได้ด้วย Geocoding API ดูการสาธิตเพิ่มเติม ตัวอย่าง พารามิเตอร์ที่ใช้ได้ รหัสสถานะและข้อความแสดงข้อผิดพลาด รวมถึงรายละเอียดอื่นๆ ได้ใน คู่มือนักพัฒนาซอฟต์แวร์ของ Geocoding API
คู่มือสําหรับนักพัฒนาซอฟต์แวร์ Geocoding API อธิบายเว็บเซอร์วิส Geocoding API มีไว้สำหรับนักพัฒนาเว็บไซต์และอุปกรณ์เคลื่อนที่ที่ต้องการใช้ข้อมูลการแปลงพิกัดภูมิศาสตร์ภายในแผนที่ที่ให้บริการโดย API ของ Google Maps Platform