เริ่มต้นใช้งาน

Geocoding API เป็นบริการที่ให้การระบุพิกัดทางภูมิศาสตร์และการทำ 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 แผนที่ ได้ง่ายขึ้นโดยให้ ใช้งานทั่วไปแบบเนทีฟ เช่น การตรวจสอบสิทธิ์ คำขอ การควบคุมและการลองอีกครั้งโดยอัตโนมัติ Geocoding API พร้อมใช้งาน ในช่วง ไคลเอ็นต์ Java ไคลเอ็นต์ Python, Go Client และ Node.js สำหรับบริการ Google Maps

การตรวจสอบสิทธิ์ โควต้า ราคา และนโยบาย

การตรวจสอบสิทธิ์

หากต้องการใช้ Geocoding API คุณต้องเปิดใช้ API ก่อน และรับข้อมูลรับรองการตรวจสอบสิทธิ์ที่เหมาะสม สำหรับข้อมูลเพิ่มเติม โปรดดู เริ่มต้นใช้งาน Google Maps Platform

โควต้าและราคา

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

นโยบาย

การใช้ Geocoding API ต้องเป็นไปตาม นโยบาย API

ดูข้อมูลเพิ่มเติม

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

คู่มือนักพัฒนาซอฟต์แวร์ Geocoding API จะอธิบาย บริการเว็บ Geocoding API มีไว้สำหรับนักพัฒนาเว็บไซต์และอุปกรณ์เคลื่อนที่ ที่ต้องการใช้ข้อมูลการระบุพิกัดทางภูมิศาสตร์ภายในแผนที่ซึ่งให้บริการโดยหนึ่งในแพลตฟอร์ม Google Maps API