Geocoding API phiên bản 4 là một dịch vụ cung cấp thông tin mã hoá địa lý, mã hoá địa lý ngược của địa chỉ và mã địa điểm, cũng như thông tin về điểm đến.
Mã hoá địa lý là quá trình chuyển đổi địa chỉ (chẳng hạn như địa chỉ đường phố) thành toạ độ địa lý (chẳng hạn như vĩ độ và kinh độ). Bạn có thể dùng toạ độ này để đặt điểm đánh dấu trên bản đồ hoặc định vị bản đồ.
Mã hoá địa lý ngược là quá trình chuyển đổi toạ độ địa lý thành địa chỉ mà con người có thể đọc được.
Bạn cũng có thể sử dụng Geocoding API để tìm địa chỉ cho một mã địa điểm nhất định.
Yêu cầu và phản hồi mẫu
Bạn truy cập vào Geocoding API thông qua một giao diện HTTP. Sau đây là ví dụ về các yêu cầu mã hoá địa lý và mã hoá địa lý ngược.
Yêu cầu và phản hồi về mã hoá địa lý (tra cứu vĩ độ/kinh độ)
Ví dụ sau đây yêu cầu vĩ độ và kinh độ của "1600 Amphitheatre Parkway, Mountain View, CA" và chỉ định rằng đầu ra phải ở định dạng JSON.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
Bạn có thể kiểm thử bằng cách nhập URL vào trình duyệt web (nhớ thay thế YOUR_API_KEY bằng khoá API thực tế của bạn).
Phản hồi bao gồm vĩ độ và kinh độ của địa chỉ.
Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về cách tạo URL yêu cầu mã hoá địa lý, các tham số có sẵn và cách hiểu phản hồi.
Dưới đây là một phản hồi mẫu về mã hoá địa lý, ở định dạng JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
Yêu cầu và phản hồi mã hoá địa lý ngược (tra cứu địa chỉ)
Ví dụ sau đây yêu cầu địa chỉ tương ứng với một vĩ độ/kinh độ nhất định ở Brooklyn, New York, Hoa Kỳ. Tham số này chỉ định rằng đầu ra phải ở định dạng JSON.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYBạn có thể kiểm thử bằng cách nhập URL vào trình duyệt web (nhớ thay thế "YOUR_API_KEY" bằng khoá API thực tế của bạn). Phản hồi này bao gồm một địa chỉ mà con người đọc được cho vị trí vĩ độ và kinh độ.
Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về cách tạo URL yêu cầu mã hoá địa lý ngược, các tham số có sẵn và cách hiểu phản hồi.
Dưới đây là một phản hồi mẫu về tính năng địa lý mã hoá ngược, ở định dạng JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
Xác thực, hạn mức, giá và chính sách
Xác thực
Để sử dụng Geocoding API, trước tiên bạn phải bật API này và lấy thông tin xác thực phù hợp. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.
Hạn mức và giá
Xem trang mức sử dụng và thanh toán để biết thông tin chi tiết về hạn mức và mức giá được đặt cho Geocoding API.
Chính sách
Bạn phải sử dụng Geocoding API theo chính sách API.