API mã hóa địa lý là dịch vụ cung cấp mã hóa địa lý và mã hóa địa lý ngược địa chỉ.
Mã hóa địa lý là quá trình chuyển đổi địa chỉ (như địa chỉ đường phố) thành toạ độ địa lý (như vĩ độ và kinh độ) mà bạn có thể sử dụng để đặ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ý sang một địa chỉ mà con người có thể đọc được.
Bạn cũng có thể sử dụng API mã hoá địa lý để tìm địa chỉ cho một mã địa điểm đã cho.
Yêu cầu và phản hồi mẫu
Bạn truy cập API Mã hóa địa lý thông qua giao diện HTTP. Đang theo dõi là các ví dụ về mã hóa địa lý và yêu cầu mã hóa địa lý đảo ngược.
Yêu cầu và phản hồi mã hoá địa lý (tra cứu vĩ độ/kinh độ)
Ví dụ sau yêu cầu vĩ độ và kinh độ của "Nhà hát 1600" Parkway, Mountain View, CA" và chỉ định rằng dữ liệu đầu ra phải ở định dạng JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Bạn có thể kiểm tra URL này bằng cách nhập URL vào trình duyệt web (hãy nhớ thay thế
YOUR_API_KEY bằng khoá API thực tế của bạn).
Câu trả lờ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ề đang tạo URL yêu cầu mã hoá địa lý và các thông số có sẵn và hiểu câu trả lời.
Dưới đây là phản hồi mã hoá địa lý mẫu, trong 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"
}
Đảo ngược yêu cầu và phản hồi mã hoá địa lý (tra cứu địa chỉ)
Ví dụ sau đây yêu cầu địa chỉ tương ứng với một vĩ độ/kinh độ cho trước ở Brooklyn, New York, Hoa Kỳ. Phương thức này chỉ định rằng dữ liệu đầu ra phải ở định dạng JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
Bạn có thể kiểm tra URL này bằng cách nhập URL vào trình duyệt web (hãy nhớ thay thế "YOUR_API_KEY" bằng khoá API thực tế của bạn). Câu trả lời bao gồm địa chỉ vĩ độ và kinh độ mà con người có thể đọc được vị trí.
Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về tạo URL yêu cầu mã hoá địa lý ngược và các thông số có sẵn và hiểu câu trả lời.
Dưới đây là phản hồi mã hoá địa lý đảo ngược mẫu, trong 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"
}
Bắt đầu lập trình bằng các thư viện ứng dụng của chúng tôi
Thư viện ứng dụng tạo phát triển bằng API dịch vụ web của Google Maps dễ dàng hơn bằng cách cung cấp các cách triển khai gốc của các tác vụ phổ biến, chẳng hạn như xác thực, yêu cầu điều tiết và tự động thử lại. API mã hoá địa lý có sẵn trong Ứng dụng Java, Ứng dụng Python, Go Client và ứng dụng Node.js cho Dịch vụ Google Maps.
Xác thực, hạn mức, giá và chính sách
Xác thực
Để sử dụng API mã hóa địa lý, trước tiên bạn phải bật API và có được thông tin xác thực phù hợp. Để biết thêm thông tin, hãy xem Bắt đầu sử dụng Nền tảng Google Maps.
Hạn mức và giá
Xem lại mức sử dụng và thanh toán để biết chi tiết về hạn mức và định giá cho API mã hóa địa lý.
Chính sách
Việc sử dụng API mã hoá địa lý phải tuân theo Chính sách về API.
Tìm hiểu thêm
Còn nhiều việc khác bạn có thể làm với API mã hoá địa lý. Xem Hướng dẫn dành cho nhà phát triển API mã hóa địa lý để có các bản minh họa bổ sung, ví dụ, các thông số có sẵn, mã trạng thái, thông báo lỗi cùng các thông tin chi tiết khác.
Hướng dẫn dành cho nhà phát triển API mã hóa địa lý mô tả Dịch vụ web API mã hoá địa lý. API này dành cho các nhà phát triển trang web và thiết bị di động muốn sử dụng dữ liệu mã hoá địa lý trong bản đồ được cung cấp bởi một trong các Nền tảng Google Maps API.