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à nhận thêm thông tin về các địa điểm. Places Service 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ể dùng lại các mã đó với 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 ứng dụng Android theo những cách sau:
- Places SDK for 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.
- 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 hoạt từ thông tin đầ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 Places Service
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 Text Search (New) REST API trong Places API để nhận 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. Bạn sẽ không mất phí khi sử dụng tính năng Tìm kiếm bằng 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 các khu vực
Dịch vụ Place Autocomplete 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ụ Tự động hoàn thành địa điểm chỉ trả về các khu vực, hãy 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 Places SDK 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 để thu phóng đến một ranh giới.
- Lấy loại đối tượng cho ranh giới (ví dụ:
locality). - Nhận đị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, Hoa Kỳ").
- Nhận 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 độ 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 tốt với kiểu dựa trên dữ liệu cho ranh giới:
- Sử dụng tính năng Geocoding để lấy khung hiển thị 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 lý để nhận 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 địa lý mã hoá 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 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ý sẽ 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_KEYSử dụng tính năng chuyển đổi địa chỉ thành toạ độ địa lý có 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 đâ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 để nhận tất cả cá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