Bạn có thể sử dụng Dịch vụ địa điểm và Geocoding API với Maps SDK cho Android để tìm kiếm các khu vực và xem thêm thông tin về địa điểm. Dịch vụ địa điểm và Geocoding API là những lựa chọn 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 ranh giới.
Thêm Dịch vụ địa điểm và Mã hoá địa lý vào Maps SDK cho các ứng dụng 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ề địa điểm bằng cách sử dụng các 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 hoạt 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 văn bản (Mới) để tìm Mã địa điểm
Bạn có thể sử dụng Tìm kiếm văn bản (Mới) API REST trong Places API để lấy mã địa điểm bao gồm dữ liệu vùng 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 tính năng Tìm kiếm văn bản (Mới) để 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 Tự động hoàn thành địa điểm để 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 để cho phép
người dùng tìm kiếm các khu vực. Để định cấu hình dịch vụ Place Autocomplete để chỉ trả về các vùng, hãy sử dụng AutocompleteSupportFragment.setTypesFilter(List) để đặt bộ lọc loại thành PlaceTypes.REGIONS.
Xem 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 Places SDK cho Android trả về dữ liệu cho một khu vực có thể rất hữu ích. Ví dụ:
- Tìm kiế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 tính năng cho ranh giới (ví dụ:
locality). - Lấy địa chỉ được định dạng, địa chỉ này phân giải thành "Tên địa điểm, Tiểu bang, Quốc gia" trong khu vực Hoa Kỳ (ví dụ: "Ottumwa, IA, Hoa Kỳ").
- Lấy các 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 một địa chỉ thành toạ độ vĩ độ và kinh độ và Mã địa điểm, hoặc chuyển đổi toạ độ vĩ độ và kinh độ hoặc Mã địa điểm thành một địa chỉ. Các cách sử dụng sau đây kết hợp tốt với đị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 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 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ả 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) để đưa ra 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. Ví dụ sau đây về hàm dịch vụ mã hoá địa lý trả về Mã địa điểm cho tất cả các thành phần địa chỉ ở toạ độ vĩ độ và kinh độ đã 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í đã 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 hạn chế về thành phần bằng tính năng mã hoá địa lý ngược để chỉ lấy tất cả các thành phần địa chỉ tại vị trí đã chỉ định cho loại locality:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY