Bạn có thể sử dụng Dịch vụ địa điểm và Geocoding API cùng với Maps SDK cho Android để tìm thông tin về các khu vực và xem thêm thông tin về các địa điểm. Dịch vụ địa điểm và Geocoding API là những giải pháp thay thế mạnh mẽ và ổn định để lấy mã địa điểm. Nếu đã sử dụng mã địa điểm, bạn có thể sử dụng lại các mã đó bằng tính năng định kiểu dựa trên dữ liệu cho ranh giới.
Thêm Dịch vụ địa điểm và Mã hoá địa lý vào ứng dụng Maps SDK cho Android theo những cách sau:
- Places SDK cho Android là một thư viện Android chứa các phương thức trả về thông tin về địa điểm.
- Places API trả về thông tin về các địa điểm bằng cách sử dụng yêu cầu HTTP.
- Lớp Geocoder có thể mã hoá địa lý và mã hoá địa lý ngược một cách linh động từ hoạt động đầu vào của người dùng.
- Geocoding API cho phép bạn mã hoá địa lý các địa chỉ tĩnh, đã biết.
Sử dụng Dịch vụ địa điểm
Sử dụng tính năng Tìm kiếm bằng văn bản (mới) để tìm mã địa điểm
Bạn có thể sử dụng API REST Tìm kiếm bằng văn bản (Mới) trong Places API để lấy mã địa điểm có chứa dữ liệu khu vực bằng cách chỉ định places.id trong mặt nạ trường. Bạn sẽ không bị tính phí khi sử dụng dịch vụ Tìm kiếm văn bản (Mới) chỉ để yêu cầu mã địa điểm. Tìm hiểu thêm.
Ví dụ: để lấy mã địa điểm cho Trinidad, CA, bạn có thể thực hiện lệnh gọi API sau:
curl -X POST -d '{
"textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'Sử dụng tính năng Place Autocomplete để tìm khu vực
Dịch vụ Tự động hoàn thành địa điểm trong Places SDK cho Android cung cấp một cách thuận tiện để người dùng tìm kiếm khu vực. Để định cấu hình dịch vụ Place Autocomplete chỉ trả về các khu vực, hãy sử dụng AutocompleteSupportFragment.setTypesFilter(List) để đặt bộ lọc loại thành PlaceTypes.REGIONS.
Lấy thông tin chi tiết về địa điểm cho một khu vực
Dịch vụ Chi tiết địa điểm trong SDK Địa điểm cho Android trả về dữ liệu cho một khu vực có thể khá hữu ích. Ví dụ như bạn có thể:
- Tìm mã địa điểm ranh giới dựa trên tên địa điểm.
- Lấy khung nhìn để thu phóng đến một ranh giới.
- Lấy loại đối tượng cho ranh giới (ví dụ:
locality). - Lấy địa chỉ được định dạng, phân giải thành "Tên địa điểm, Tiểu bang, Quốc gia" ở khu vực Hoa Kỳ (ví dụ: "Ottumwa, IA, USA").
- Nhận dữ liệu hữu ích khác, chẳng hạn như ảnh.
Sử dụng Geocoding API
Geocoding API cho phép bạn 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ỉ. Các trường hợp sử dụng sau đây kết hợp hiệu quả với tính năng định kiểu dựa trên dữ liệu cho ranh giới:
- Sử dụng tính năng Mã hoá địa lý để lấy khung nhìn cho một khu vực.
- Áp dụng tính năng lọc thành phần cho lệnh gọi Mã hoá địa lý để lấy mã địa điểm cho khu vực hành chính 1-4, địa phương hoặc mã bưu chính.
- Sử dụng tính năng mã hoá địa lý ngược để tìm mã địa điểm theo toạ độ vĩ độ và kinh độ, hoặc thậm chí trả về mã địa điểm cho tất cả thành phần ở một vị trí cụ thể.
Ví dụ sau đây sử dụng một địa chỉ (đã thoát URL) để gửi yêu cầu đến Geocoding API:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEYBạn có thể sử dụng tính năng mã hoá địa lý ngược để tìm mã địa điểm. Hàm dịch vụ Mã hoá địa lý trong ví dụ sau đây trả về mã địa điểm cho tất cả thành phần địa chỉ tại toạ độ vĩ độ và kinh độ được chỉ định:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEYSử dụng tính năng mã hoá địa lý ngược với tính năng lọc thành phần để lấy thành phần địa chỉ cho một hoặc nhiều loại sau đây tại vị trí được chỉ định:
administrativeAreacountrylocalitypostalCode
Hàm ví dụ tiếp theo cho thấy cách sử dụng dịch vụ Mã hoá địa lý, thêm các quy định hạn chế về thành phần bằng tính năng mã hoá địa lý ngược để lấy tất cả thành phần địa chỉ tại vị trí được chỉ định chỉ cho loại locality:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY