Bằng cách tích hợp SDK điều hướng cho Android, ứng dụng của bạn có thể vượt ra ngoài việc liên kết với một chế độ xem bản đồ bên ngoài. Với tính năng đi theo chỉ dẫn của Google Maps, ứng dụng của bạn có thể cung cấp tính năng truy xuất động và báo cáo dữ liệu một lần về hành trình của người dùng. Hướng dẫn này giải thích cách chạy ứng dụng minh hoạ SDK điều hướng có trên GitHub.
Chuẩn bị
Để bắt đầu sử dụng SDK điều hướng, hãy nhớ có các mục sau đây.
Người đại diện của Nền tảng Google Maps để có quyền truy cập vào các thông tin sau:
- Khoá API được cấp phép để sử dụng với SDK điều hướng. Bạn cần cung cấp mã dự án (projectID) có trong trang tổng quan chính của Google Cloud Console, bên dưới tên dự án.
- Cấu phần phần mềm SDK. Hãy đảm bảo dự án của bạn được định cấu hình để sử dụng Maven cho SDK điều hướng.
- Đối với các dự án sử dụng phiên bản 4.99.0 trở xuống. Nếu không sử dụng được Maven, bạn có thể tải cấu phần phần mềm đã nén xuống từ Google Drive dùng chung. Tệp thư viện tĩnh là .aar trong thư mục
libs/
chứa SDK điều hướng dưới dạng một gói AAR. - Một hoặc nhiều ứng dụng minh hoạ.
- Android Studio, môi trường phát triển được đề xuất để tạo ứng dụng bằng SDK điều hướng.
Tài liệu này dành cho những người đã làm quen với các khái niệm lập trình hướng đối tượng và phát triển Android. Bạn cũng nên làm quen với Google Maps từ góc nhìn của người dùng.
Tải ứng dụng minh hoạ
Google cung cấp 2 ứng dụng để giúp bạn hiểu các tính năng mà SDK điều hướng cung cấp ngoài API Google Maps, tuỳ thuộc vào cấp độ trải nghiệm của bạn. Các nhà phát triển quen thuộc với API Google Maps có thể tập trung sự chú ý của họ vào bản minh hoạ GoogleNavigation. Những nhà phát triển mới thực hiện cả hai dự án sẽ thấy cả hai ứng dụng đều hữu ích.
Kể từ SDK điều hướng cho Android phiên bản 4.1, cả hai ứng dụng minh hoạ sau đây đều có sẵn trên GitHub để tải xuống.
Bản minh hoạ GoogleNavigation: Cho thấy tính năng tích hợp hành vi và khung hiển thị API liên quan đến trải nghiệm của người dùng trong phiên điều hướng có hướng dẫn.
Bản minh hoạ GoogleMap: thể hiện các hành vi riêng lẻ của giao diện
GoogleMap
để tuỳ chỉnh giao diện và cách trình bày của bản đồ.
Lưu ý khi sử dụng Maven
Các ứng dụng minh hoạ được định cấu hình để tải cấu phần phần mềm SDK xuống từ kho lưu trữ Maven từ xa bằng cách sử dụng trình bổ trợ Artifact Registry trong Gradle. Hãy nhớ làm theo hướng dẫn về cấu hình dự án để có quyền truy cập vào SDK.
Bản minh hoạ GoogleNavigation
Bản minh hoạ GoogleNavigation mới nhất hiện có trên GitHub.
Tòa nhà
Trong Android Studio, hãy nhập ứng dụng minh hoạ và cho phép Gradle chạy.
Mở
local.defaults.properties
và cập nhật giá trị của thuộc tínhMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Nhấp vào bản dựng rồi kiểm tra thông tin chi tiết về phương thức triển khai SDK.
Trong lớp Java, hãy ghi lại mã triển khai.
Trong XML bố cục, hãy lưu ý đến thiết kế bố cục và văn bản.
Trong tệp
build.gradle
, hãy ghi chú SDK trong phần phụ thuộc.
Xem tài liệu về Trình bổ trợ Bí mật cho Gradle để biết thêm thông tin về cách thêm khoá API vào tệp kê khai.
Chạy
Kết nối thiết bị Android với máy tính hoặc dùng một trình mô phỏng.
- Thiết bị Android – Hãy tham khảo instructions để bật các tuỳ chọn cho nhà phát triển trên thiết bị Android và định cấu hình hệ thống nhằm phát hiện thiết bị.
- Trình mô phỏng mdash; Sử dụng Trình quản lý thiết bị Android ảo (AVD) để định cấu hình thiết bị ảo. Khi chọn một trình mô phỏng, hãy nhớ chọn hình ảnh chứa các API của Google.
Trong Android Studio, hãy nhấp vào tuỳ chọn trình đơn Run (Chạy) (hoặc biểu tượng nút phát); sau đó chọn mục tiêu triển khai.
Khi được tạo và khởi chạy, ứng dụng sẽ hiển thị cho người dùng trang đích chứa danh sách các tuỳ chọn.
Các tuỳ chọn NavViewActivity và NavFragmentActivity
Những người sử dụng NavSDK mới có thể sẽ thấy hai tuỳ chọn này hữu ích nhất.
Tuỳ chọn 1: NavViewActivity
thể hiện các hành vi bằng cách sử dụng NavigationView
cùng với Navigator
.
Tuỳ chọn 2: Tuỳ chọn thứ hai có tiêu đề NavFragmentActivity
giới thiệu các hành vi bằng cách sử dụng SupportNavigationFragment
cùng với Navigator
.
Khi nhấp vào một trong các tuỳ chọn này, bạn sẽ thấy như sau:
- giao diện người dùng điều hướng
- nút "Đặt đích" trong trình đơn của ứng dụng
- một lớp phủ mà bạn có thể tương tác để tự động gọi các phương thức trên API
- một trình đơn mục bổ sung có nhiều tuỳ chọn hơn
Để bắt đầu, hãy nhấp vào Đặt điểm đến và chọn một địa chỉ. Sau đó, ứng dụng này sẽ mô phỏng một chuyến đi từ vị trí hiện tại của bạn đến địa chỉ đó. Sử dụng lớp phủ bảng điều khiển để xem điều gì sẽ xảy ra khi bạn gọi một API. Ví dụ: bạn có thể nhấp vào View Methods (Phương thức xem) để thử buộc SDK chuyển sang chế độ ban đêm để xem giao diện của SDK.
Tuỳ chọn SwappingMapAndNavActivity
SwappingMapAndNavActivity
cho thấy các mẫu phổ biến sau:
- hiển thị
MapView
- hoán đổi sang
NavigationView
khi bắt đầu điều hướng - quay lại
MapView
khi quá trình điều hướng kết thúc
Bản minh hoạ GoogleMap
Bản minh hoạ GoogleNavigation mới nhất hiện có trên GitHub.
Tòa nhà
Trong Android Studio, hãy nhập ứng dụng minh hoạ và cho phép Gradle chạy.
Mở
local.defaults.properties
và cập nhật giá trị của thuộc tínhMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Nhấp vào bản dựng rồi kiểm tra thông tin chi tiết về phương thức triển khai SDK.
Trong lớp Java, hãy ghi lại mã triển khai.
Trong XML bố cục, hãy lưu ý đến thiết kế bố cục và văn bản.
Trong tệp
build.gradle
, hãy ghi chú SDK trong phần phụ thuộc.
Xem trình bổ trợ secrets gradle để biết thêm thông tin về cách thêm khoá API vào Tệp kê khai.
Chạy
Kết nối thiết bị Android với máy tính hoặc dùng một trình mô phỏng.
- Thiết bị Android Hãy tham khảo instructions để bật các tuỳ chọn cho nhà phát triển trên thiết bị Android và định cấu hình hệ thống nhằm phát hiện thiết bị.
- Trình mô phỏng Sử dụng Trình quản lý thiết bị Android ảo (AVD) để định cấu hình thiết bị ảo. Khi chọn một trình mô phỏng, hãy nhớ chọn hình ảnh chứa các API của Google.
Trong Android Studio, hãy nhấp vào tuỳ chọn trình đơn Run (Chạy) (hoặc biểu tượng nút phát); sau đó chọn mục tiêu triển khai.
Khi được tạo và khởi chạy, ứng dụng sẽ hiển thị cho người dùng trang đích chứa danh sách bản minh hoạ.
Mẫu trình bày này và cấu trúc tương ứng của mã nguồn phải quen thuộc với người dùng bản minh hoạ SDK của Google Maps. Lý do là bản minh hoạ GoogleMap được thiết kế để tương tự như ứng dụng minh hoạ API Maps. Điểm khác biệt chính là bản minh hoạ SDK điều hướng cho phép người dùng chọn lớp chế độ xem mà họ muốn chạy thử bản minh hoạ: NavigationView
hoặc MapView
, nếu có.
Google thường khuyến khích người dùng sử dụng NavigationView
.
Bản minh hoạ này cho phép bạn linh hoạt thử các hành vi này trên cả hai phiên bản trong ứng dụng minh hoạ và chọn phiên bản phù hợp với bạn. Ví dụ: có thể bạn vẫn cần phải sử dụng MapView
trong trường hợp đang dùng thư viện bên thứ ba dự kiến sẽ tương tác với lớp đó.