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

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 ลงในเว็บเบราว์เซอร์ (แทนที่คีย์ API จริงแทน YOUR_API_KEY) คําตอบจะมีละติจูดและลองจิจูดของที่อยู่

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้าง 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 Client และ Node.js Client สําหรับบริการ Google Maps

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

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

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

โควต้าและการกําหนดราคา

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

นโยบาย

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

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

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

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