Geocoding API là một dịch vụ chấp nhận địa điểm dưới dạng địa chỉ, toạ độ vĩ độ và kinh độ hoặc Mã địa điểm. API này chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ cũng như Mã địa điểm, hoặc chuyển đổi toạ độ vĩ độ và kinh độ hoặc Mã địa điểm thành địa chỉ.
Geocoding API phiên bản 4 cung cấp cả thông tin chi tiết về điểm đến và điểm đến theo từng khu vực cụ thể và độ phân giải từ toạ độ đến địa chỉ cốt lõi. Cho dù bạn đang xây dựng trải nghiệm giao hàng chặng cuối, đi chung xe hay đi theo từng chặng, hay chuẩn hoá địa chỉ đường phố thành toạ độ, thì phiên bản 4 đều cung cấp các điểm cuối chuyên biệt phù hợp với trường hợp sử dụng của bạn.
Bạn không biết chắc điểm cuối nào phù hợp với ứng dụng của mình? Xem phần Chọn phương thức mã hoá địa lý.
Những việc bạn có thể làm với Geocoding API
Geocoding API phiên bản 4 bao gồm các chức năng và điểm cuối sau:
- Tìm điểm đến: Truy xuất thông tin chi tiết về điểm đến theo từng khu vực cụ thể từ địa chỉ, Mã địa điểm hoặc toạ độ, bao gồm cả lối vào toà nhà, mã thông báo điểm điều hướng có thể định tuyến, đường viền toà nhà và khuôn viên, điểm đến phụ và địa danh lân cận.
- Mã hoá địa lý một địa chỉ: Chuyển đổi địa chỉ đường phố thành toạ độ địa lý và Mã địa điểm (mã hoá địa lý chuyển tiếp).
- Mã hoá địa lý một vị trí: Chuyển đổi toạ độ vĩ độ và kinh độ thành địa chỉ đường phố hoặc khu vực hành chính mà con người có thể đọc được (mã hoá địa lý ngược).
- Mã hoá địa lý một địa điểm: Truy xuất thông tin chi tiết và toạ độ của địa chỉ được định dạng cho một Mã địa điểm đã biết trên Google Maps.
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ể.
Xem bản minh hoạ
Cách hoạt động của Geocoding API
Geocoding API phiên bản 4 hỗ trợ tính năng tìm kiếm điểm đến cùng với tính năng mã hoá địa lý cơ bản:
- Tìm kiếm điểm đến (
SearchDestinations): Phân giải địa chỉ, Mã địa điểm hoặc cặp toạ độ thành một đối tượngDestinationđa dạng. Hãy sử dụng phương thức này khi việc đến nơi thực tế là quan trọng, chẳng hạn như xác định lối vào toà nhà ưu tiên, chỉ đường cho tài xế đến điểm đón hoặc trả khách được chỉ định bằng mã thông báo điểm điều hướng, hiển thị dấu chân toà nhà trên bản đồ hoặc điều hướng các khu phức hợp nhiều toà nhà. - Mã hoá địa lý cơ bản: Chuyển đổi giữa địa chỉ, toạ độ và Mã địa điểm:
- Mã hoá địa lý: Chuyển đổi địa chỉ đường phố (chẳng hạn như "1600 Amphitheatre Parkway, Mountain View, CA") thành toạ độ vĩ độ và kinh độ hoặc Mã địa điểm để đặt điểm đánh dấu trên bản đồ hoặc căn giữa khung xem bản đồ.
- Mã hoá địa lý ngược: Chuyển đổi toạ độ vĩ độ và kinh độ hoặc Mã địa điểm thành địa chỉ đường phố mà con người có thể đọc được cho các ghim bản đồ do người dùng thả, bộ chọn vị trí hoặc màn hình giao diện người dùng.
- Mã hoá địa lý địa điểm: Truy xuất thông tin chi tiết về địa chỉ và toạ độ cho một Mã địa điểm đã biết trên Google Maps.
Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Geocoding API phiên bản 4 cùng với dữ liệu mà mỗi phương thức trả về:
| Tài nguyên dữ liệu | Dữ liệu được trả về | Định dạng trả về |
|---|---|---|
| Tìm điểm đến ( POST /v4/geocode/destinations)
|
Trả về thông tin chi tiết về điểm đến theo từng khu vực cụ thể: đa giác của toà nhà và khuôn viên (displayPolygon), entrances thực tế, navigationPoints có thể định tuyến (có mã thông báo), containingPlaces và subDestinations phân cấp, landmarks quan hệ và thông tin chi tiết về địa điểm chính. Xem bài viết Tìm điểm đến.
|
|
| Mã hoá địa lý một địa chỉ ( GET /v4/geocode/address)
|
Trả về địa chỉ, thành phần địa chỉ và loại địa chỉ. Xem Phản hồi mã hoá địa lý. | |
| Mã hoá địa lý một vị trí ( GET /v4/geocode/location)
|
Trả về địa chỉ, thành phần địa chỉ và loại địa chỉ. Xem Phản hồi mã hoá địa lý ngược. | |
| Mã hoá địa lý một địa điểm ( GET /v4/geocode/places)
|
Trả về địa chỉ, thành phần địa chỉ và loại địa chỉ. Xem Phản hồi về mã hoá địa lý địa điểm. |
Ra mắt kênh sân khấu
Phiên bản 4 của Geocoding API có các kênh riêng biệt cho các tính năng GA, Bản xem trước và Thử nghiệm. Nếu bạn muốn sử dụng các tính năng Xem trước hoặc Thử nghiệm, hãy nhớ chỉ định đúng kênh trong yêu cầu của bạn. Ví dụ:
để truy cập vào các tính năng của điểm cuối Đích đến trong phiên bản Thử nghiệm, hãy sử dụng yêu cầu HTTP
sau: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Giai đoạn ra mắt | Tên kênh |
|---|---|
| Số bàn bị ghi | /v4/ |
| Xem trước | /v4beta/ |
| Thử nghiệm | /v4alpha/ |
- Xem tài liệu tham khảo về REST để biết danh sách và nội dung mô tả về tất cả tài nguyên REST hiện có.
- Hãy xem phần giai đoạn phát hành để biết thêm thông tin về từng giai đoạn.
Các tính năng trong Geocoding API phiên bản 4
Phiên bản 4 của Geocoding API cung cấp các tính năng mới sau đây.
Phương thức tìm kiếm điểm đến
Phiên bản 4 ra mắt phương thức tìm kiếm Điểm đến, cho phép bạn truy xuất thông tin chi tiết về nhiều điểm đến dựa trên các tiêu chí đầu vào khác nhau, chẳng hạn như địa chỉ, mã địa điểm hoặc toạ độ vĩ độ và kinh độ. Câu trả lời bao gồm bản tóm tắt dựa trên AI và mã thông báo điểm điều hướng chứa thông tin theo bối cảnh có thể được truyền đến SDK Điều hướng để định tuyến chính xác.
Được triển khai trên nền tảng tiêu chuẩn của Google Cloud
Geocoding API phiên bản 4 được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Việc triển khai này mang lại một nền tảng an toàn và đáng tin cậy hơn, với các lựa chọn bảo mật nâng cao như OAuth. Thiết kế API tiêu chuẩn này mang lại sự nhất quán giữa các API, giúp cải thiện hiệu quả phát triển bằng Geocoding API phiên bản 4.
Đã thêm tính năng hỗ trợ OAuth
Geocoding API phiên bản 4 hỗ trợ việc sử dụng OAuth 2.0 để xác thực. Google hỗ trợ các trường hợp OAuth 2.0 phổ biến, chẳng hạn như các trường hợp dành cho máy chủ web.
Đã thêm tính năng hỗ trợ mặt nạ trường
Sử dụng mặt nạ trường để chỉ định thông tin mà phản hồi sẽ trả về. Đối với các phương thức Mã hoá địa lý một địa chỉ, Mã hoá địa lý một vị trí và Mã hoá địa lý địa điểm, tất cả các trường trong đối tượng phản hồi đều được trả về theo mặc định. Đối với phương thức Tìm kiếm điểm đến, bạn phải chỉ định một mặt nạ trường trong yêu cầu API.
Bảo mật API
Geocoding API phiên bản 4 được thiết kế dưới dạng API giữa các máy chủ. Các lệnh gọi trực tiếp phía máy khách từ trình duyệt khiến khoá API có nguy cơ bị đánh cắp và sử dụng sai mục đích, vì các quy định hạn chế về liên kết giới thiệu HTTP không đủ để bảo vệ các điểm cuối của dịch vụ web.
Bạn nên gọi Geocoding API phiên bản 4 từ máy chủ phụ trợ của riêng bạn. Để biết thêm thông tin chi tiết về các mẫu triển khai an toàn và giải pháp thay thế cho nhu cầu phía máy khách, hãy xem phần Những điều cần lưu ý về bảo mật.