Mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Mã địa điểm được chấp nhận trong các yêu cầu tới các API Maps sau đây:
- Truy xuất địa chỉ cho một ID địa điểm trong dịch vụ web Geocodes API và Dịch vụ mã hoá địa lý, Maps JavaScript API.
- Chỉ định điểm gốc, điểm đến và điểm trung gian trong API Tuyến đường và API Hướng dẫn dịch vụ web và Dịch vụ chỉ đường, API Maps JavaScript.
- Việc chỉ định nguồn gốc và đích đến trong API Tuyến và Dịch vụ web API Ma trận khoảng cách và Dịch vụ ma trận khoảng cách, API Maps JavaScript.
- Truy xuất Thông tin chi tiết về địa điểm trong dịch vụ web API Địa điểm, SDK địa điểm dành cho Android, SDK địa điểm dành cho iOS và Thư viện địa điểm.
- Sử dụng thông số Mã địa điểm trong API Nhúng của Maps.
- Đang truy xuất cụm từ tìm kiếm trong URL của Maps.
- Hiển thị giới hạn tốc độ trong API đường.
- Tìm và tạo kiểu cho đa giác ranh giới trong định kiểu theo hướng dữ liệu cho ranh giới.
Tìm mã nhận dạng của một địa điểm cụ thể
Bạn đang tìm mã địa điểm của một địa điểm cụ thể? Sử dụng mã địa điểm trình tìm bên dưới để tìm kiếm một địa điểm và lấy mã của địa điểm đó:
Ngoài ra, bạn có thể xem trình tìm mã địa điểm cùng với mã trong Maps JavaScript API tài liệu.
Tổng quan
Mã địa điểm là giá trị nhận dạng dạng văn bản giúp xác định duy nhất một địa điểm. Chiến lược phát hành đĩa đơn độ dài của mã nhận dạng có thể khác nhau (không có độ dài tối đa cho mã địa điểm). Ví dụ:
-
ChIJgUbEo8cfqokR5lP9_Wh_DaM
-
GhIJQWDl0CIeQUARxks3icF8U8A
-
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
-
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
-
IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ
Mã địa điểm có sẵn cho hầu hết các vị trí, bao gồm cả doanh nghiệp, địa danh, công viên và giao lộ. Cùng một địa điểm hoặc vị trí có thể có nhiều mã địa điểm. Mã địa điểm có thể thay đổi theo thời gian.
Bạn có thể sử dụng cùng một mã địa điểm trong Places API và số lượng API của Nền tảng Google Maps. Ví dụ: bạn có thể sử dụng cùng một mã địa điểm để tham chiếu đến một địa điểm trong API Địa điểm, API JavaScript của Maps, API mã hoá địa lý, API Nhúng của Maps và API Đường.
Truy xuất thông tin chi tiết về địa điểm bằng cách sử dụng mã địa điểm
Một cách phổ biến để sử dụng mã địa điểm là tìm một địa điểm (sử dụng API Địa điểm hoặc Địa điểm thư viện trong Maps JavaScript API) thì hãy sử dụng mã địa điểm được trả về để truy xuất thông tin chi tiết về địa điểm. Bạn có thể lưu trữ mã địa điểm và sử dụng nó để truy xuất thông tin chi tiết về địa điểm đó sau này. Đọc về đang lưu mã địa điểm bên dưới.
Ví dụ về cách sử dụng thư viện Địa điểm trong API Maps JavaScript
Để sử dụng mã địa điểm trong ứng dụng JavaScript, trước tiên, bạn phải tìm mã đó,
có sẵn trong PlaceResult
được trả về bởi
Địa điểm
Tìm kiếm hoặc bằng getPlace()
trong
Địa điểm
Dịch vụ Tự động hoàn thành. Sau đó, bạn có thể sử dụng mã địa điểm để tra cứu
địa điểm
chi tiết.
var map; function initialize() { // Create a map centered in Pyrmont, Sydney (Australia). map = new google.maps.Map(document.getElementById('map'), { center: {lat: -33.8666, lng: 151.1958}, zoom: 15 }); // Search for Google's office in Australia. var request = { location: map.getCenter(), radius: '500', query: 'Google Sydney' }; var service = new google.maps.places.PlacesService(map); service.textSearch(request, callback); } // Checks that the PlacesServiceStatus is OK, and adds a marker // using the place ID and location from the PlacesService. function callback(results, status) { if (status == google.maps.places.PlacesServiceStatus.OK) { var marker = new google.maps.Marker({ map: map, place: { placeId: results[0].place_id, location: results[0].geometry.location } }); } } google.maps.event.addDomListener(window, 'load', initialize);
Lưu mã địa điểm để sử dụng sau này
Mã địa điểm được miễn khỏi các quy định hạn chế về việc lưu vào bộ nhớ đệm nêu trong Mục 3.2.3(b) về Điều khoản dịch vụ của Nền tảng Google Maps. Do đó, bạn có thể lưu trữ các giá trị mã địa điểm để sử dụng sau này sử dụng.
Đang làm mới mã địa điểm đã lưu trữ
Bạn nên làm mới mã địa điểm nếu đã quá 12 tháng. Bạn
có thể làm mới ID địa điểm miễn phí, bằng cách tạo một
Yêu cầu về Thông tin chi tiết về địa điểm,
chỉ chỉ định place_id
trong tham số fields
.
Lệnh gọi này kích hoạt
Thông tin chi tiết về địa điểm – Làm mới mã nhận dạng
SKU.
Yêu cầu này cũng có thể trả về trạng thái NOT_FOUND
. Một chiến lược là lưu trữ yêu cầu ban đầu đã trả về từng địa điểm
Mã nhận dạng. Nếu mã địa điểm không hợp lệ, bạn có thể gửi lại yêu cầu đó để làm mới
kết quả. Những kết quả này có thể bao gồm hoặc không bao gồm địa điểm ban đầu. Tuy nhiên, yêu cầu này
có thể tính phí.
Mã lỗi khi sử dụng mã địa điểm
Mã trạng thái INVALID_REQUEST
cho biết rằng thuộc tính
mã địa điểm không hợp lệ. INVALID_REQUEST
có thể được trả về khi
mã địa điểm đã bị cắt bớt hoặc sửa đổi và không còn chính xác nữa.
Mã trạng thái NOT_FOUND
cho biết mã địa điểm đã chỉ định
đã lỗi thời. Mã địa điểm có thể trở nên lỗi thời nếu doanh nghiệp đóng cửa hoặc chuyển sang
một vị trí mới. Mã địa điểm có thể thay đổi do những nội dung cập nhật trên quy mô lớn trên Google
Cơ sở dữ liệu của Maps. Trong những trường hợp như vậy, một địa điểm có thể nhận được mã địa điểm mới và mã địa điểm cũ
Mã nhận dạng trả về phản hồi NOT_FOUND
.
Cụ thể, một số loại mã địa điểm đôi khi có thể gây ra
NOT_FOUND
phản hồi hoặc API có thể trả về một mã địa điểm khác trong
nội dung phản hồi. Các loại mã địa điểm này bao gồm:
- Địa chỉ đường phố không tồn tại trong Google Maps là địa chỉ chính xác, nhưng được suy ra từ một loạt địa chỉ.
- Các đoạn của một tuyến đường dài, trong đó yêu cầu cũng nêu rõ một thành phố hoặc địa phương.
- Giao lộ.
- Địa điểm có thành phần địa chỉ thuộc loại
subpremise
.
Các mã này thường ở dạng chuỗi dài (không có độ dài tối đa cho Mã địa điểm). Ví dụ:
EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4