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

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 Client และ Node.js สำหรับบริการของ Google Maps

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

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

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

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

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

นโยบาย

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

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

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

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