Bạn có thể sử dụng dịch vụ Địa điểm và API mã hoá địa lý với SDK bản đồ dành cho Android để tìm kiếm các khu vực và nhận thêm thông tin về các địa điểm. Dịch vụ Địa điểm và API mã hoá địa lý là các lựa chọn thay thế hiệu quả và ổn định để thu thập 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ã đó với định kiểu dựa trên dữ liệu cho các ranh giới.
Thêm dịch vụ Địa điểm và Mã hóa địa lý vào SDK bản đồ dành cho ứng dụng Android theo những cách sau:
- SDK Địa điểm dành 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.
- API Địa điểm trả về thông tin về địa điểm bằng cách sử dụng yêu cầu HTTP.
- Lớp bộ mã hoá địa lý có thể mã hoá địa lý và mã hoá địa lý đảo ngược một cách linh động từ hoạt động đầu vào của người dùng.
- API mã hoá địa lý cho phép bạn mã hoá địa lý theo địa chỉ tĩnh, đã biết.
Sử dụng dịch vụ Địa điểm
Sử dụng Tìm kiếm văn bản (Mới) để tìm mã địa điểm
Bạn có thể sử dụng tính năng Tìm kiếm văn bản (Mới)
API REST trong Places API để lấy mã địa điểm có bao gồm cả khu vực
bằng cách chỉ định places.id trong mặt nạ trường. Việc sử dụng
Tìm kiếm văn bản (Mới) để yêu cầu mã địa điểm chỉ phát sinh
mà không mất phí. Tìm hiểu thêm.
Ví dụ: để lấy mã địa điểm cho Trinidad, CA, bạn có thể làm như sau Lệnh gọi API:
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 Tự động hoàn thành của địa điểm để tìm khu vực
Tính năng Tự động hoàn thành theo địa điểm
trong SDK Địa điểm dành cho Android cung cấp một cách thuận tiện để cho phép
người dùng của bạn tìm kiếm khu vực. Để định cấu hình dịch vụ Tự động hoàn thành của địa điểm để
chỉ trả lại các khu vực, sử dụng
AutocompleteSupportFragment.setTypesFilter(List)
để đặt bộ lọc loại thành PlaceTypes.REGIONS.
Xem chi tiết địa điểm cho một khu vực
Thông tin chi tiết về địa điểm trong SDK địa điểm dành 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.
- Tải khung nhìn để thu phóng 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" inch khu vực Hoa Kỳ (ví dụ: "Ottumwa, IA, USA").
- Nhận dữ liệu hữu ích khác như ảnh.
Sử dụng API mã hóa địa lý
API mã hoá địa lý cho phép bạn chuyển đổi địa chỉ thành vĩ độ và kinh độ cùng với Mã địa điểm hoặc chuyển đổi vĩ độ và kinh độ hoặc ID địa điểm vào một địa chỉ. Nội dung sau đây sử dụng kết hợp tốt với định kiểu theo hướng dữ liệu cho các ranh giới:
- Sử dụng Mã hóa địa lý để nhận chế độ xem cho một khu vực.
- Áp dụng lọc thành phần cho cuộc gọi Mã hóa địa lý của bạn để lấy ID địa điểm cho khu vực hành chính 1-4, địa phương hoặc mã bưu điện.
- Sử dụng mã hoá địa lý ngược để tìm mã địa điểm theo vĩ độ và kinh độ toạ độ hoặc thậm chí trả về mã địa điểm cho tất cả các thành phần trong một vị trí.
Ví dụ sau đây sử dụng một địa chỉ (thoát url) để gửi yêu cầu đến API mã hoá địa lý:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY
Bạn có thể sử dụng mã hóa địa lý đảo ngược để tìm mã địa điểm. Mã hoá địa lý ví dụ sau hàm service trả về ID địa điểm cho tất cả thành phần địa chỉ tại vĩ độ và kinh độ chỉ định:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
Sử dụng mã hóa đị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 việc sử dụng dịch vụ Mã hóa địa lý, thêm thành phần
với mã hoá địa lý ngược để có được tất cả các thành phần địa chỉ tại
vị trí được chỉ định riêng cho loại locality:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY