SDK bản đồ dành cho mã mẫu Android

Chọn nền tảng: Android iOS JavaScript

Kho lưu trữ Maps SDK dành cho Android trên GitHub bao gồm các mẫu minh hoạ việc sử dụng SDK Maps dành cho Android trong ứng dụng Android của bạn.

Kho lưu trữ chứa ứng dụng ApiDemos, một ứng dụng mẫu cho phép bạn tạo và chạy các mẫu từ một ứng dụng Android. Nhập và tạo thêm ứng dụng, thêm khoá API, xem bản minh hoạ và sử dụng mã mẫu được cung cấp dưới dạng điểm khởi đầu cho ứng dụng của mình.

Khi chạy ứng dụng mẫu, bạn sẽ thấy danh sách các mẫu có sẵn mà bạn có thể chạy trên thiết bị của chính bạn. Chọn một trong các mục sau. Ví dụ: nhấp vào Bản đồ cơ bản.

Khắc phục sự cố: Nếu ứng dụng mẫu chạy thành công nhưng bạn không thấy map, hãy kiểm tra để đảm bảo rằng bạn đã thêm khoá API vào tệp kê khai của ứng dụng, như được mô tả trong phần Sử dụng khoá API.

Danh sách ứng dụng mẫu SDK Maps dành cho Android

Các hoạt động mẫu chính có trong SDK bản đồ dành cho Android Ứng dụng ApiDemos được liệt kê bên dưới và được tái tạo tại các trang được liên kết để tham khảo nhanh. Xem Kotlin hoặc Java để xem danh sách đầy đủ các mẫu có sẵn.

Sao chép và chạy mẫu

Bạn cần có Git để chạy mẫu này trên máy. Lệnh sau đây sẽ sao chép mẫu kho lưu trữ ứng dụng.

git clone git@github.com:googlemaps-samples/android-samples.git

Nhập dự án mẫu vào Android Studio:

  1. Trong Android Studio, chọn File > (Tệp >) Mới > Nhập dự án.
  2. Chuyển đến vị trí bạn đã lưu kho lưu trữ rồi chọn thư mục dự án cho Kotlin hoặc Java:

    • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
    • Java: PATH-REPO/android-samples/ApiDemos/java
  3. Chọn Open (Mở). Android Studio sẽ tạo dự án của bạn bằng bản dựng Gradle .
  4. Tạo một tệp secrets.properties trống trong cùng thư mục với tệp local.properties của dự án. Để biết thêm thông tin, hãy xem phần Thêm khoá API vào dự án.
  5. Thêm chuỗi sau vào secrets.properties, thay thế YOUR_API_KEY bằng giá trị của khoá API của bạn:

    MAPS_API_KEY=YOUR_API_KEY
  6. Chạy ứng dụng.

Ứng dụng mẫu cho bản đồ trên Wear OS

Ứng dụng mẫu của SDK Maps dành cho Android trên Wear OS là có trên GitHub, mà bạn có thể sử dụng làm điểm bắt đầu khi tạo một ứng dụng cho thiết bị đeo. Mẫu này cho bạn biết cách thiết lập một Bản đồ Google cơ bản trên Wear OS.