Các tính năng của SDK Địa điểm dành cho Android có trong ứng dụng của bạn được xác định dựa trên tổ hợp số phiên bản SDK (ví dụ: 3.5.0) mà bạn chỉ định trong cấu hình ứng dụng, API được bật trên khoá API và cách bạn khởi chạy ứng dụng. Hướng dẫn này giải thích sự khác biệt giữa các phiên bản và cách chọn phiên bản được bật trong ứng dụng.
Số phiên bản SDK
Số phiên bản của SDK mà bạn chỉ định trong tệp build.gradle ở cấp ứng dụng sẽ xác định liệu ứng dụng của bạn có quyền truy cập vào các tính năng đã được thêm trong một bản phát hành cụ thể hay không. Ví dụ: tính năng Tự động hoàn thành (Mới) chỉ có trong SDK phiên bản 3.5.0 trở lên.
Để biết thêm thông tin về những thay đổi được giới thiệu trong mỗi phiên bản SDK, hãy xem Ghi chú phát hành của SDK Địa điểm cho Android.
Phiên bản API Địa điểm cho SDK Địa điểm dành cho Android
Ngoài việc chỉ định số phiên bản SDK, bạn cũng phải chọn dịch vụ Places API mà SDK gọi trong Google Cloud Console: Places API hoặc Places API (Mới). Cùng với số phiên bản SDK, dịch vụ API mà bạn chọn sẽ xác định phiên bản của các tính năng cụ thể có trong ứng dụng của bạn, chẳng hạn như tính năng Tự động hoàn thành hoặc Tự động hoàn thành (Mới). Mặc dù chỉ có thể chỉ định một số phiên bản SDK, nhưng bạn có thể bật cả Places API và Places API (Mới) trên khoá API cùng lúc, sau đó chọn dịch vụ mà SDK gọi thông qua phương thức bạn dùng để khởi chạy SDK trong ứng dụng. Tuy nhiên, trong hầu hết các trường hợp, bạn nên bật Places API (Mới) và sử dụng phiên bản (Mới) của các tính năng SDK trong ứng dụng.
Chọn phiên bản SDK và dịch vụ API
Để chọn những tính năng SDK có trong ứng dụng, hãy làm như sau:
- Trong dự án Google Cloud, hãy bật Places API, Places API (Mới) hoặc cả hai. Để biết thêm thông tin, hãy xem bài viết Bật API
- Trong các hạn chế về khoá API, hãy bật Places API, Places API (Mới) hoặc cả hai. Để biết thêm thông tin, hãy xem phần Hạn chế khoá API.
Trong tệp build.gradle cấp ứng dụng, hãy chỉ định số phiên bản. Để biết thêm thông tin, hãy xem phần Cài đặt.
Khởi động ứng dụng bằng cách gọi phương thức
Places.initializeWithNewPlacesApiEnabled()hoặcPlaces.initialize().
Để biết thêm thông tin về cách chọn dịch vụ Places API, hãy xem phần Thiết lập dự án Google Cloud.
Các tính năng SDK có trong mỗi phiên bản
Bảng sau đây cho biết những phiên bản SDK và API cần thiết cho từng tính năng SDK:
| Tính năng | Đã bật Places API trên khoá API | Phương thức khởi động | Phiên bản SDK tối thiểu |
|---|---|---|---|
| Tự động hoàn thành (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Thông tin về địa điểm (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Tìm kiếm lân cận (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Ảnh địa điểm (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Tìm kiếm văn bản (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Tự động hoàn thành địa điểm | Places API | initialize() |
|
| Địa điểm hiện tại | Places API | initialize() |
|
| Thông tin về địa điểm | Places API | initialize() |
|
| Hình ảnh về địa điểm | Places API | initialize() |
Những yếu tố nên cân nhắc khi chọn phiên bản để bật
Để quyết định nên chọn phiên bản nào, hãy xem xét những điều sau:
- Nếu bạn là khách hàng mới và chỉ mới bắt đầu sử dụng SDK Địa điểm dành cho Android, hãy bắt đầu bằng Places API (Mới) và SDK mới.
- Nếu đang là khách hàng thì bạn có thể tiếp tục sử dụng SDK hiện tại. Tuy nhiên, để tận dụng các điểm cải tiến về hiệu suất và các tính năng nâng cao của SDK Địa điểm dành cho Android (Mới), bạn nên sử dụng SDK mới. Bạn không cần di chuyển khi chuyển sang SDK mới, chỉ cần làm theo các bước trong bài viết Chọn phiên bản SDK và dịch vụ API.
- Trong SDK Địa điểm dành cho Android (Mới), mã thông báo phiên sẽ có sẵn kể từ phiên bản 3.5.0. Để biết thêm thông tin, hãy xem phần Mã thông báo của phiên.
- Các lệnh gọi được thực hiện bằng tiện ích Tự động hoàn thành địa điểm luôn gọi Tự động hoàn thành địa điểm, chứ không phải tính năng Tự động hoàn thành địa điểm (Mới); các lệnh gọi tiện ích không bị ảnh hưởng bởi phương thức khởi chạy.
- Place Photos (New) (Địa điểm ảnh (Mới)) chỉ trả về URI đến hình ảnh bitmap, trong khi Place Photos chỉ trả về hình ảnh bitmap.
- Current Place chỉ có trong SDK Địa điểm dành cho Android, không có trong SDK Địa điểm dành cho Android (Mới).
Các tính năng nâng cao trong SDK Địa điểm dành cho Android (Mới)
Phần này đề cập đến các tính năng chính được thêm vào SDK Địa điểm dành cho Android (Mới).
Được triển khai trên nền tảng tiêu chuẩn của Google Cloud
SDK Địa điểm dành cho Android (Mới) được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Cách triển khai này mang đến một nền tảng an toàn và đáng tin cậy hơn. Thiết kế chuẩn này mang lại mức độ nhất quán trên các SDK, giúp cải thiện hiệu quả phát triển bằng SDK Địa điểm dành cho Android (Mới).
Cải tiến hiệu suất
Địa điểm SDK dành cho Android (Mới) cải thiện hiệu suất, khiến bạn nên thay thế các ứng dụng sử dụng SDK hiện có.
Tính năng mới
SDK Địa điểm dành cho Android (Mới) bao gồm các phiên bản mới nhất của tất cả các tính năng của SDK:
- Tự động hoàn thành (Mới)
- Thông tin về địa điểm (Mới)
- Tìm kiếm lân cận (Mới)
- Ảnh địa điểm (Mới)
- Tìm kiếm văn bản (Mới)
Dịch vụ Tìm kiếm văn bản mới
Tìm kiếm văn bản (Mới) trả về thông tin về một nhóm địa điểm dựa trên một chuỗi – ví dụ: "pizza ở New York" hoặc "cửa hàng giày gần Ottawa" hoặc "123 Main Street". Dịch vụ phản hồi bằng một danh sách các địa điểm khớp với chuỗi văn bản và mọi sai lệch vị trí đã đặt.
Đã thêm dữ liệu mới về câu trả lời vào Thông tin chi tiết về địa điểm (Mới) và Ảnh địa điểm (Mới)
Place Details (Thông tin chi tiết về địa điểm) (Mới) hiện bao gồm lớp Review (Xem lại) mới trong đối tượng
Placephản hồi. Lớp Place chứa phương thứcgetReviews()mới để hỗ trợ trường này. Hãy gọigetReviews()để trả về tối đa 5 bài đánh giá cho một địa điểm.Place Photo (Ảnh địa điểm mới) sẽ thêm
AuthorAttributionsvào lớpPhotoMetadata.AuthorAttributionschứaListcác đối tượngAuthorAttribution.
Đã thêm phản hồi URI mới vào Ảnh địa điểm (Mới)
Giờ đây, bạn có thể sử dụng Place Photo (Mới) để trả về URI về một bitmap hình ảnh. Trước đây, bạn chỉ có thể trả về chính bitmap hình ảnh.
Giá đơn giản
Việc định giá được đơn giản hoá với SDK Địa điểm dành cho Android (Mới) để bạn chỉ phải thanh toán cho dữ liệu mà bạn sử dụng. Quy trình đặt giá đơn giản được triển khai bằng cách sử dụng danh sách trường, còn gọi là mặt nạ trường.
Với Thông tin địa điểm và Tìm kiếm văn bản, bạn sử dụng danh sách trường để kiểm soát danh sách trường cần trả về trong phản hồi. Sau đó, bạn sẽ chỉ bị tính phí cho dữ liệu được yêu cầu. Việc sử dụng danh sách trường là một phương pháp thiết kế hay để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và phí thanh toán không cần thiết.
Để biết thông tin chi tiết về giá cho cả hai SDK, hãy xem phần Sử dụng và thanh toán.
Loại địa điểm được mở rộng
SDK mới thêm các loại địa điểm hiển thị trong bảng sau. Các loại này được trả về như một phần của phản hồi Thông tin chi tiết về địa điểm và Tìm kiếm văn bản. Bạn cũng có thể sử dụng các kiểu mới này và các kiểu hiện có khi tìm kiếm bằng tính năng Tìm kiếm văn bản. Các loại mới được đưa vào Bảng A.
| Loại | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | trang trại | korean_restaurant | sporting_goods_store |
| barber_shop | nghỉ trang trại | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | marina | sports_complex |
| brazilian_restaurant | ferry_terminal | khu chợ | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | tuỳ chỉnh |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | khách sạn ven đường cho khách có ô tô | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| tư vấn viên | sân bay trực thăng | playground | vegetarian_restaurant |
| convention_center | hiking_area | mẫu giáo | vietnamese_restaurant |
| nhà nghỉ ngoại ô | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | nhà nghỉ | resort_hotel | nhà bán buôn |
| dental_clinic | hotel | rest_stop |
Cùng với các loại mới này, Places API (Mới) đã chuyển các loại sau từ Bảng 2 cho Places API sang Bảng A cho Places API (Mới). Điều đó có nghĩa là giờ đây, bạn có thể sử dụng các loại sau trong quá trình tìm kiếm:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality