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 bao gồm: được xác định theo 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 của bạn, các API được bật trên khoá API và cách bạn khởi chạy ứng dụng của bạn. 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 của bạn.
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 tệp 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 vào trong một bản phát hành cụ thể. 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 phần Địa điểm Bản phát hành SDK dành cho Android lưu ý.
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 Địa điểm Dịch vụ API mà SDK gọi trong Google Cloud Console: API Địa điểm 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ó sẵn trong ứng dụng của bạn, như Tự động hoàn thành hoặc Tự động hoàn thành (Mới). Mặc dù bạn chỉ có thể chỉ định một SDK số phiên bản, bạn có thể bật cả Places API và Places API (Mới) trên khoá API cùng một lúc, sau đó chọn dịch vụ mà SDK gọi thông qua phương thức bạn sử dụng để khởi chạy SDK trong ứng dụng của mình. Tuy nhiên, trong hầu hết các trường hợp, bạn sẽ muố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 của bạn.
Chọn phiên bản SDK và dịch vụ API
Để chọn tính năng SDK nào có trong ứng dụng của bạn, 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 phần Bật API
- Trong các quy định hạn chế đối với 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ế API khoá.
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, xem Cài đặt.
Khởi chạy ứ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 Thiết lập Dự án trên Google Cloud.
Các tính năng SDK có trong từng phiên bản
Bảng sau đây trình bày những phiên bản SDK và API cần thiết cho từng SDK tính năng:
Tính năng | Đã bật API địa điểm trên khoá API | Phương thức khởi tạo | 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 chi tiết 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 về đị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 chi tiết về địa điểm | Places API | initialize() |
|
Hình ảnh địa điểm | Places API | initialize() |
Những điều cần cân nhắc khi chọn phiên bản cần bật
Để giúp bạn 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 chỉ mới bắt đầu sử dụng SDK Địa điểm dành cho Android, thì hãy bắt đầu với Places API (Mới) và SDK mới.
- Nếu đang là khách hàng, bạn có thể tiếp tục sử dụng SDK hiện có. Tuy nhiên, để tận dụng những điểm cải tiến về hiệu suất và tính năng các tính năng nâng cao của Places SDK dành cho Android (Mới), bạn nên sử dụng SDK. Bạn không cần phải 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à API luôn miễn phí.
- Trong SDK Địa điểm dành cho Android (Mới), mã thông báo phiên bắt đầu có sẵn trong phiên bản 3.5.0. Để biết thêm thông tin, hãy xem Phiên mã thông báo.
- Các cuộc 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 Place Tự động hoàn thành chứ không phải 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 khởi tạo.
- Ảnh về địa điểm (Mới) chỉ trả về URI cho hình ảnh bitmap, trong khi Place Photos chỉ trả về một bitmap hình ảnh.
- Địa điểm hiện tại là chỉ có sẵn 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 Google Cloud
SDK Địa điểm dành cho Android (Mới) được triển khai trên dịch vụ cơ sở hạ tầng 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ế tiêu chuẩn này mang lại mức độ nhất quán giữa các SDK giúp cải thiện hiệu quả phát triển với SDK địa điểm dành cho Android (Mới).
Cải tiến hiệu suất
SDK Địa điểm dành cho Android (Mới) cải thiện hiệu suất, giúp đáng giá để thay thế các ứng dụng 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ả SDK đó tính năng:
- Tự động hoàn thành (Mới)
- Thông tin chi tiết về địa điểm (Mới)
- Tìm kiếm lân cận (Mới)
- Ảnh về đị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 tập hợp đị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ụ sẽ phản hồi bằng một danh sách địa điểm phù hợp với chuỗi văn bản và bất kỳ sai lệch vị trí nào đã được đặt.
Đã thêm dữ liệu câu trả lời mới vào Thông tin chi tiết về địa điểm (Mới) và Ảnh về địa điểm (Mới)
Thông tin chi tiết về địa điểm (Mới) nay bao gồm cả Bài đánh giá trong đối tượng
Place
phản hồi. Chiến lược phát hành đĩa đơn Lớp Place (Địa điểm) chứa phương thứcgetReviews()
mới để hỗ trợ trường này. Gọi điệngetReviews()
để trả lại tối đa 5 bài đánh giá cho một địa điểm.Ảnh địa điểm (Mới) sẽ thêm
AuthorAttributions
vào lớpPhotoMetadata
.AuthorAttributions
chứaList
làAuthorAttribution
.
Đã thêm phản hồi URI mới vào Ảnh của địa điểm (Mới)
Bạn hiện có thể dùng Ảnh địa điểm (Mới) để trả về URI cho một bitmap hình ảnh. Trước đây, bạn chỉ có thể trả lại chính bitmap hình ảnh.
Định giá đơn giản
Việc đặt giá được đơn giản hoá với SDK Địa điểm dành cho Android (Mới) để bạn chỉ trả tiền cho dữ liệu bạn sử dụng. Phương thức định giá đơn giản được triển khai bằng cách sử dụng danh sách trường, còn được gọi là fieldMask (mặt nạ trường).
Có thông tin chi tiết về đị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 cần trả về trong phản hồi. Sau đó, bạn sẽ chỉ phải thanh toán cho dữ liệu đã yêu cầu. Sử dụng danh sách trường là một phương pháp thiết kế hiệu quả để đả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ý không cần thiết và các khoản phí thanh toán.
Để biết thông tin chi tiết về giá cho cả hai SDK, hãy tham khảo bài viết Cách sử dụng và Thanh toán.
Loại địa điểm mở rộng
SDK mới sẽ thêm các loại địa điểm như trong bảng sau. Những loại này được trả lại như một phần của Chi tiết địa điểm và Câu trả lời của tính năng Tìm kiếm văn bản. Bạn cũng có thể sử dụng các loại mới này, và các loại hiện có, trong tìm kiếm bằng Tìm kiếm văn bản. Các loại mới được bao gồm trong Bảng Đáp:.
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 | lưu trú ở trang trại | lebanese_restaurant | sports_club |
bed_and_breakfast | fast_food_restaurant | marina | sports_complex |
brazilian_restaurant | ferry_terminal | market | steak_house |
breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
bus_stop | gift_shop | mexican_restaurant | thợ may |
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 |
nhà tư vấn | sân bay trực thăng | sân chơi | vegetarian_restaurant |
convention_center | hiking_area | mầm non | 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 đến 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 này như một phần của tìm kiếm:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality