Chọn phiên bản SDK của bạn

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 bằng cách kế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ác 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 xác định xem ứ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ề các thay đổi được đưa vào trong mỗi phiên bản SDK, hãy xem ghi chú phát hành SDK Địa điểm cho Android.

Các 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ụ API Địa điểm mà SDK gọi trong Google Cloud Console: API Địa điểm hoặc API Địa điểm (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, chẳng hạn như 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ả API Địa điểm và API Địa điểm (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. Tuy nhiên, trong hầu hết các trường hợp, bạn nên bật API Địa điểm (Mới) và sử dụng các 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 các tính năng SDK có trong ứng dụng, hãy làm như sau:

  1. Trong dự án Google Cloud, hãy bật API Địa điểm, API Địa điểm (Mới) hoặc cả hai. Để biết thêm thông tin, hãy xem phần Bật API
  2. Trong các quy tắc 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ế khoá API.

  3. 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.

  4. Khởi chạy ứng dụng bằng cách gọi phương thức Places.initializeWithNewPlacesApiEnabled() hoặc Places.initialize().

Để biết thêm thông tin về cách chọn dịch vụ API Địa điểm, hãy xem bài viết 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 các 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 API Địa điểm trên khoá API Phương thức khởi chạy 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
Hình ảnh về địa điểm (Mới) Places API (Mới) initializeWithNewPlacesApiEnabled() 3.4.0
Tìm kiếm bằng 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 về địa điểm Places API initialize()

Những điều cần cân nhắc khi chọn phiên bản để bật

Để giúp bạn quyết định nên chọn phiên bản nào, hãy cân nhắc những điều sau:

  • Nếu bạn là khách hàng mới và mới bắt đầu sử dụng SDK Địa điểm dành cho Android, hãy bắt đầu với API Địa điểm (Mới) và SDK mới.
  • 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à tính năng của SDK Địa điểm 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 phần 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 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 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ự độ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 (Mới) chỉ trả về URI đến một hình ảnh bitmap, trong khi Place Photos chỉ trả về một hình ảnh bitmap.
  • Địa điểm hiện tại chỉ có trong SDK Địa điểm dành cho Android, chứ không có trong SDK Địa điểm dành cho Android (Mới).

Các điểm cải tiến trong SDK Địa điểm dành cho Android (Mới)

Phần này trình bày 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

SDK Địa điểm dành cho Android (Mới) giúp cải thiện hiệu suất, nê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ả tính năng SDK:

Dịch vụ Tìm kiếm văn bản mới

Tìm kiếm bằng 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ụ này 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 độ lệch vị trí đã được đặt.

Thêm dữ liệu phản hồi mới vào mục Thông tin chi tiết về vị trí đặt (Mới) và Ảnh địa điểm (Mới)

Thêm phản hồi URI mới vào tính năng Ảnh địa điểm (Mới)

Giờ đây, bạn có thể sử dụng Place Photo (Đặt ảnh) (Mới) để trả về URI cho bitmap hình ảnh. Trước đây, bạn chỉ có thể trả về bitmap hình ảnh.

Giá đơn giản

SDK Địa điểm dành cho Android (Mới) giúp đơn giản hoá việc định giá để bạn chỉ trả tiền cho dữ liệu mà bạn sử dụng. Tính năng định 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 tính năng Chi tiết địa điểm và Tìm kiếm bằng văn bản, bạn sử dụng danh sách trường để kiểm soát danh sách trường sẽ trả về trong phản hồi. Sau đó, bạn chỉ phải trả phí cho dữ liệu đã yêu cầu. Bạn nên sử dụng danh sách trường để đả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ề mức giá của cả hai SDK, hãy xem phần Mức sử dụng và tính phí.

Các loại địa điểm mở rộng

SDK mới thêm các loại địa điểm như trong bảng sau. Các loại này được trả về trong phần phản hồi Thông tin chi tiết về địa điểm và Tìm kiếm bằng 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 một lượt tìm kiếm bằng tính năng Tìm kiếm bằng 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 nhà nghỉ dưỡng ở 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 điều 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
chuyên viên 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) đã di chuyển các loại sau đây từ Bảng 2 của Places API sang Bảng A của 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 trong một nội dung tìm kiếm:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality