Tổng quan về API mã hoá địa lý

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Geocoding API là một dịch vụ chấp nhận một địa điểm dưới dạng địa chỉ, toạ độ vĩ độ và kinh độ hoặc mã địa điểm. Dịch vụ này chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ cũng như một mã địa điểm, hoặc chuyển đổi toạ độ vĩ độ và kinh độ hoặc một mã địa điểm thành địa chỉ.

Những việc bạn có thể làm với Geocoding API

Bạn có thể sử dụng Geocoding API để lấy dữ liệu mã hoá địa lý cho một hoặc nhiều địa chỉ hoặc địa điểm, bao gồm cả những dữ liệu sau:

  • Toạ độ địa lý cho địa chỉ.
  • Địa chỉ cho các bộ toạ độ vĩ độ và kinh độ.
  • Địa chỉ cho mã địa điểm.

Bạn có thể kiểm soát vị trí xuất hiện của kết quả và giới hạn kết quả ở một khu vực, quận hoặc mã bưu chính cụ thể.

Cách hoạt động của Geocoding API

Geocoding API thực hiện cả hoạt động mã hoá địa lý và mã hoá địa lý ngược:

  • Mã hoá địa lý: Chuyển đổi các địa chỉ như "1600 Amphitheatre Parkway, Mountain View, CA" thành toạ độ vĩ độ và kinh độ hoặc mã địa điểm. Bạn có thể dùng các toạ độ này để đặt điểm đánh dấu trên bản đồ hoặc để căn giữa hoặc định vị lại bản đồ trong khung hiển thị.
  • Mã hoá địa lý ngược: Chuyển đổi toạ độ vĩ độ/kinh độ hoặc một Place ID thành địa chỉ mà con người có thể đọc được. Bạn có thể sử dụng địa chỉ cho nhiều trường hợp, bao gồm cả giao hàng hoặc đến lấy hàng.

Bản minh hoạ sau đây sử dụng Dịch vụ mã hoá địa lý thông qua API Maps JavaScript để minh hoạ cách hoạt động của API mã hoá địa lý. Mở bản đồ trong một thẻ riêng để xem thêm các lựa chọn và thông tin chi tiết.

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Geocoding API cùng với dữ liệu mà mỗi điểm cuối trả về.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Mã hoá địa lý Trả về địa chỉ, các thành phần địa chỉ và loại địa chỉ. Xem Kết quả trong hướng dẫn Yêu cầu và phản hồi về mã hoá địa lý.
  • JSON
  • XML
Mã hoá địa lý ngược Trả về địa chỉ, các thành phần địa chỉ và loại địa chỉ. Xem Phản hồi mã hoá địa lý ngược trong hướng dẫn Yêu cầu và phản hồi mã hoá địa lý ngược.
Mã hoá địa lý cho địa điểm Trả về địa chỉ, các thành phần địa chỉ và loại địa chỉ. Xem Phản hồi mã hoá địa lý ngược trong hướng dẫn về yêu cầu và phản hồi mã hoá địa lý của địa điểm.

Cách sử dụng Geocoding API

1 Thiết lập. Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn tất hướng dẫn thiết lập sau đây.
2 Thử yêu cầu mã hoá địa lý Sau khi có khoá API, bạn có thể bắt đầu kiểm thử Geocoding API ngay từ curl hoặc trình duyệt. Bạn sẽ cần cung cấp các tham số tìm kiếm chính xác để tìm kiếm địa chỉ hoặc thành phần. Hãy xem phần Tham số mã hoá địa lý để biết thông tin chi tiết.
3 Thử yêu cầu mã hoá địa lý ngược Cung cấp toạ độ vĩ độ/kinh độ cùng với khoá API để nhận các thành phần địa chỉ cho địa chỉ dễ đọc nhất của vị trí đó. Hãy xem phần Yêu cầu về mã hoá địa lý ngược để biết thông tin chi tiết.
4 Tìm hiểu những điều cơ bản về phản hồi Tất cả các điểm cuối trong Geocoding API đều trả về cùng một dữ liệu ở định dạng JSON hoặc XML. Hãy xem phần Phản hồi mã hoá địa lý để biết nội dung giải thích về dữ liệu, mã trạng thái và thông báo lỗi.
5 Kết hợp dữ liệu mã hoá địa lý vào ứng dụng của riêng bạn! Bạn có thể sử dụng dữ liệu mã hoá địa lý để lấy địa chỉ từ các điểm đánh dấu trên bản đồ hoặc cung cấp các điểm đánh dấu trên bản đồ dựa trên một địa chỉ đã biết.

Các thư viện ứng dụng hiện có

Gọi API này bằng ngôn ngữ bạn chọn thông qua một trong các thư viện ứng dụng sau:

Ứng dụng Java, ứng dụng Python, ứng dụng Go và ứng dụng Node.js cho Dịch vụ Google Maps là các thư viện ứng dụng được cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Tải các tệp này xuống từ GitHub, nơi bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Bước tiếp theo