Dùng thử bản trình diễn

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 sang chế độ xem bản đồ bên ngoài. Với điều hướng của Google Maps, ứng dụng của bạn có thể cung cấp 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 Navigation đều có trên GitHub.

Chuẩn bị

Để bắt đầu sử dụng SDK điều hướng, hãy chắc chắn rằng các mục sau.

  • 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 projectID mà bạn có thể tìm thấy trong trang tổng quan chính của Google Cloud Console, trong tên dự án.
    • Cấu phần phần mềm SDK. Đảm bảo rằng bạn đã định cấu hình dự án để 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 dùng được Maven, bạn có thể 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 với tư cách là 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 với SDK điều hướng.

Tài liệu này dành cho những người làm quen với việc phát triển Android và các khái niệm lập trình hướng đối tượng. Bạn cũng nên làm quen với Google Bản đồ 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 nắm được SDK điều hướng cung cấp bên cạnh API Google Maps, tùy thuộc vào cấp độ trải nghiệm của bạn. 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à phát triển mới sử dụng cả hai dự án nào cũng sẽ thấy cả hai ứng dụng này hữu ích.

Kể từ SDK điều hướng dành cho Android phiên bản 4.1, các ứng dụng minh hoạ sau đây đều có trên GitHub để tải xuống.

  • Bản minh hoạ GoogleNavigation: Giới thiệu sự tích hợp của các hành vi API và chế độ xem phù hợp với trải nghiệm của người dùng trong khi điều hướng có hướng dẫn .

  • Bản minh hoạ GoogleMap: thể hiện hành vi riêng lẻ của 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 qua Maven từ xa kho lưu trữ này, bằng cách sử dụng trình bổ trợ Artifact Registry trong Gradle. Hãy nhớ tuân thủ hướng dẫn định 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à

  1. Trong Android Studio, hãy nhập ứng dụng minh hoạ và cho phép Gradle chạy.

  2. Mở local.defaults.properties rồi cập nhật giá trị của MAPS_API_KEY thuộc tính:

      MAPS_API_KEY=YOUR_API_KEY
    
  3. 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 Bí mật Gradle trình bổ trợ để biết thêm thông tin về cách thêm khoá API vào tệp kê khai.

Chạy

  1. 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 hướng dẫn cho bật tuỳ chọn cho nhà phát triển trên thiết bị Android và định cấu hình hệ thống của bạn để phát hiện thiết bị.
    • Trình mô phỏngmdash;Sử dụng Thiết bị Android ảo (AVD) Người quản lý cho định cấu hình thiết bị ảo. Khi chọn một trình mô phỏng, hãy đảm bảo bạn chọn một hình ảnh bao gồm các API của Google.
  2. Trong Android Studio, hãy nhấp vào tuỳ chọn trình đơn Run (Chạy) (hoặc nút phát) icon); rồi chọn mục tiêu triển khai.

Khi được tạo và chạy, ứng dụng sẽ hiển thị cho người dùng trang đích của một danh sách tùy chọn.

Những người sử dụng NavSDK mới có thể sẽ thấy hai lựa chọn này là phù hợp nhất hữu ích hơn.

Cách 1: NavViewActivity thể hiện các hành vi bằng NavigationView liên kết với Navigator.

Lựa chọn 2: Lựa chọn thứ hai, có tiêu đề NavFragmentActivity, giới thiệu thông qua 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
  • "Đặt điểm đến" nút 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 mô phỏng chuyến đi từ vị trí hiện tại của bạn đến địa chỉ đó. Sử dụng bảng điều khiển 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 method (Phương thức xem) để thử buộc SDK chuyển sang chế độ ban đêm để xem trông như thế nào.

Tuỳ chọn SwappingMapAndNavActivity

SwappingMapAndNavActivity cho thấy các mẫu phổ biến sau:

  • hiển thị MapView
  • đang hoán đổi sang NavigationView khi bắt đầu đi theo chỉ dẫn
  • quay lại MapView khi kết thúc đi theo chỉ dẫn

Bản minh hoạ GoogleMap

Bản minh hoạ GoogleNavigation mới nhất hiện có trên GitHub.

Tòa nhà

  1. Trong Android Studio, hãy nhập ứng dụng minh hoạ và cho phép Gradle chạy.

  2. Mở local.defaults.properties rồi cập nhật giá trị của MAPS_API_KEY thuộc tính:

      MAPS_API_KEY=YOUR_API_KEY
    
  3. 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 secrets gradle trình bổ trợ để biết thêm thông tin về cách thêm khoá API vào Tệp kê khai.

Chạy

  1. 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 Tham khảo hướng dẫn để bật các tuỳ chọn dành cho nhà phát triển trên thiết bị Android và định cấu hình phát hiện thiết bị.
    • Trình mô phỏng sử dụng Thiết bị Android ảo (AVD) Người quản lý để định cấu hình một thiết bị ảo. Khi chọn một trình mô phỏng, hãy đảm bảo bạn chọn một hình ảnh bao gồm các API của Google.
  2. Trong Android Studio, hãy nhấp vào tuỳ chọn trình đơn Run (Chạy) (hoặc nút phát) icon); rồi chọn mục tiêu triển khai.

Khi được tạo và chạy, ứng dụng sẽ hiển thị cho người dùng trang đích của một 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. Điều này là do Bản minh hoạ GoogleMap được thiết kế để tương tự như bản minh hoạ API Maps ứng dụng. Chính điểm khác biệt là bản minh hoạ SDK điều hướng cho phép người dùng chọn lớp chế độ xem họ muốn chạy thử một bản minh hoạ về: NavigationView hoặc MapView, nếu có.

Google thường khuyến khích người sử dụng sử dụng NavigationView. Bản minh hoạ này mang đến sự linh hoạt để thử những hành vi này trên cả hai phiên bản trong ứng dụng minh hoạ của chúng tôi và chọn cách phù hợp với bạn. Ví dụ: có thể vẫn là cần phải sử dụng MapView trong các trường hợp bạn đang sử dụng bên thứ ba thư viện dự kiến sẽ tương tác với lớp đó.