Bạn có thể sử dụng dịch vụ Địa điểm và API Mã hoá địa lý với SDK Maps 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ụ Places và API Mã hoá địa lý 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ã đó 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ề các đị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ý 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 văn bản (Mới) trong API Địa điểm để lấy mã địa điểm bao gồm dữ liệu 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 các 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 điền địa điểm 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.
Nhận thông tin chi tiết về địa điểm cho một khu vực
Dịch vụ 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 Địa chỉ
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 tính năng lọc thành phần cho lệnh gọi Địa chỉ được mã hoá để lấy mã địa điểm cho các 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 dịch đị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ả cá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 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 tính năng mã hoá địa lý ngược để tìm mã địa điểm. Hàm dịch vụ Địa chỉ của ví dụ sau trả về mã địa điểm cho tất cả thành phần địa chỉ tại toạ độ 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 tính năng dịch địa lý ngược với bộ lọc thành phần để lấy thành phần địa chỉ cho một hoặc nhiều loại sau tại vị trí đã chỉ định:
administrativeAreacountrylocalitypostalCode
Hàm ví dụ tiếp theo cho thấy cách sử dụng dịch vụ Địa chỉ được mã hoá, thêm các quy tắc hạn chế thành phần bằng tính năng địa chỉ được mã hoá ngược để lấy tất cả các thành phần địa chỉ tại vị trí đã 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