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 đang sử dụng mã địa điểm, bạn có thể sử dụng lại các mã đó bằng cách tạo kiểu dựa trên dữ liệu cho các ranh giới.
Thêm dịch vụ Địa điểm và tính năng Mã hoá địa lý vào SDK Maps cho ứng dụng Android theo các 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ý ngược một cách linh động từ dữ liệu đầ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í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 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ể 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 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 đ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
.
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.
- Lấy khung nhìn để phóng to 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" 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 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 cuộc gọi Mã hoá địa lý của bạn để lấy mã đị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ã hoá địa lý đảo 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 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:
administrativeArea
country
locality
postalCode
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