SDK Địa điểm dành cho Android phiên bản 3.4.0 hỗ trợ 2 phiên bản SDK: SDK địa điểm dành cho Android là SDK hiện có và SDK địa điểm dành cho Android (Mới) là phiên bản thế hệ tiếp theo của SDK.
Với việc phát hành SDK Địa điểm dành cho Android phiên bản 3.4.0, nhiệm vụ đầu tiên của bạn là quyết định xem nên sử dụng SDK nào. Điều này đúng nếu bạn là khách hàng mới hoặc khách hàng hiện tại đang sử dụng SDK. Hãy sử dụng hướng dẫn này để hiểu rõ những điểm khác biệt chính giữa 2 SDK.
Cách chọn phiên bản SDK
Trên phần phụ trợ, SDK Địa điểm dành cho Android dựa vào dịch vụ Places API, Places API (Mới) hoặc Places API. Để có thể sử dụng SDK Địa điểm dành cho Android, bạn phải bật dịch vụ API Địa điểm trong dự án Google Cloud của mình.
Đối với Android, bạn có thể thực hiện 2 hành động để xác định API có thể dùng trong ứng dụng của mình:
Trong dự án của mình, bạn phải bật Places API (Mới), Places API hoặc cả hai trên khoá API tuỳ thuộc vào cách bạn định dùng trong ứng dụng.
Khởi động ứng dụng bằng cách gọi phương thức
Places.initializeWithNewPlacesApiEnabled()hoặcPlaces.initialize().
Chọn SDK của bạn
Phiên bản của dịch vụ Places API mà bạn bật sẽ kiểm soát phiên bản SDK mà ứng dụng của bạn dùng:
Cả hai: Bật tất cả các tính năng cho cả SDK Địa điểm dành cho Android và SDK Địa điểm dành cho Android (Mới). Sử dụng phương thức
Places.initializeWithNewPlacesApiEnabled()vàPlaces.initialize()để kiểm soát các tính năng có sẵn.API Địa điểm: Bật SDK Địa điểm dành cho Android hiện có. Bạn không có quyền sử dụng các tính năng mới được thêm vào SDK Địa điểm dành cho Android phiên bản 3.4.0.
API Địa điểm (Mới): Bật SDK Địa điểm dành cho Android (Mới) và tất cả các tính năng mới được mô tả trong phần Các tính năng chính được thêm vào SDK Địa điểm dành cho Android (Mới) nhưng không bật các tính năng hiện có như Địa điểm hiện tại và Tự động hoàn thành địa điểm.
Để biết thêm thông tin về cách chọn dịch vụ Places API, hãy xem bài viết Thiết lập dự án Google Cloud.
Khởi chạy ứng dụng
Khi khởi chạy ứng dụng, bạn phải gọi phương thức Places.initializeWithNewPlacesApiEnabled() hoặc Places.initialize().
Bảng sau đây cho thấy tác động của việc bật từng SDK và gọi từng phương thức khởi động. Ví dụ: nếu bật SDK Địa điểm (Mới) và gọi Places.initializeWithNewPlacesApiEnabled(), bạn có thể sử dụng tất cả các API mới cũng như mọi API hiện có.
Nếu bật SDK Địa điểm (Mới) và gọi Places.initialize(), bạn không thể sử dụng các tính năng mới của Thông tin chi tiết về địa điểm và Ảnh về địa điểm, nhưng có thể gọi tính năng Tìm kiếm văn bản mới. Nếu không bật Places API, bạn không thể truy cập vào phiên bản cũ của Thông tin chi tiết về địa điểm nhưng vẫn có thể gọi tính năng Tìm kiếm văn bản mới.
| Phiên bản | API | Đã bật SDK trên khoá API | Phương thức khởi động | ||
|---|---|---|---|---|---|
| API Địa điểm | API Địa điểm (Mới) | initialize() |
initializeWithNewPlacesApiEnabled() |
||
| v3.3.0 | Thông tin về địa điểm | ||||
| Thông tin chi tiết về địa điểm (Mới) | |||||
| Siêu dữ liệu về ảnh (Mới) | |||||
| Tìm kiếm văn bản (Mới) | Một trong hai phương pháp | ||||
| v3.4.0 | URI ảnh (Mới) | ||||
| Ảnh bitmap | Một trong hai phương pháp | ||||
| CurrentPlace | Một trong hai phương pháp | ||||
| Tự động hoàn thành | Một trong hai phương pháp | ||||
Bạn chọn SDK nào?
Để giúp quyết định phiên bản sẽ chọn:
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, hãy bắt đầu bằng API Địa điểm (Mới) và SDK mới.
Nếu là nhà phát triển Kotlin, bạn có thể sử dụng một trong hai SDK nhưng các tính năng mới trong Địa điểm SDK dành cho Android (Mới) chỉ có trong Java ở phiên bản 3.4.0.
Nếu bạn là khách hàng hiện tại và đang sử dụng mã phiên, hãy tiếp tục sử dụng SDK hiện có. SDK Địa điểm dành cho Android (Mới) hiện không hỗ trợ mã thông báo phiên.
Nếu là khách hàng hiện tại, bạn có thể tiếp tục sử dụng SDK hiện có. 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 về tính năng của SDK Địa điểm dành cho Android (Mới), bạn có thể sử dụng SDK mới.
Bạn không cần phải di chuyển khi chuyển sang SDK mới. Bạn chỉ phải:
- Bật API Địa điểm (Mới) trên khoá API dùng trong ứng dụng. Để biết thêm thông tin, hãy xem phần Sử dụng khoá API.
Trong mục
dependenciescủa tệpbuild.gradlecấp mô-đun, hãy cập nhật phần phụ thuộcplacesrồi thêm phần phụ thuộckotlin-bom:dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0")) implementation 'com.google.android.libraries.places:places:3.3.0' }Để biết thêm thông tin về phần phụ thuộc
kotlin-bom, hãy xem bài viết Cách sử dụng phiên bản kotlin-stdlib mới nhất trong các phần phụ thuộc bắc cầu.- Hãy cập nhật ứng dụng hiện tại để gọi phương thức
Places.initializeWithNewPlacesApiEnabled()mới để khởi chạy ứng dụng. Để biết thêm thông tin, hãy xem bài viết Khởi chạy ứng dụng Places API.
Các ứng dụng hiện có của bạn sẽ tiếp tục hoạt động không thay đổi, nhưng bạn hiện có thể tận dụng tất cả tính năng mới của SDK.
Đã thêm các tính năng chính vào 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 lại 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, đáng để thay thế các ứng dụng sử dụng SDK hiện có.
Dịch vụ Tìm kiếm văn bản mới
Tìm kiếm văn bản trả về thông tin về một tập hợp các đị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 độ chệch vị trí đã đặt.
Đã thêm dữ liệu mới về câu trả lời vào Thông tin về địa điểm và Ảnh về địa điểm
Place Details (Thông tin chi tiết về địa điểm) giờ đây sẽ bao gồm lớp Review (Xem xét) 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 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
Giờ đây, bạn có thể sử dụng Place Photos (Ảnh địa điểm) để trả về URI về 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 các 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à chi 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 Mức 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ó trong lượt 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 |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality