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

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

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 ของคำขอ Geocoding และ พารามิเตอร์ที่ใช้ได้ และ การทำความเข้าใจการตอบกลับได้ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์

ด้านล่างนี้คือตัวอย่างการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ใน 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 Client, Python Client, 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 มีไว้สำหรับนักพัฒนาเว็บไซต์และแอปบนอุปกรณ์เคลื่อนที่ ที่ต้องการใช้ข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์ภายในแผนที่ที่ให้บริการโดย API ของ Google Maps Platform