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

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

Kho lưu trữ SDK Maps 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.

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à xây dựng ứng dụng, thêm khoá API, xem bản minh hoạ và dùng mã mẫu được cung cấp làm điểm xuất phát cho ứng dụng của bạn.

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 mình. Chọn một trong các lựa chọn. 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 bản đồ, hãy kiểm tra để đảm bảo bạn đã thêm khoá API vào tệp kê khai của ứng dụng, như mô tả trong phần Sử dụng khoá API.

SDK bản đồ dành cho danh sách ứng dụng mẫu Android

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

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

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

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

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

  1. Trong Android Studio, hãy chọn File > New > Import Project (Tệp > Mới > Nhập dự án).
  2. Chuyển đến vị trí bạn đã lưu kho lưu trữ và 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 Mở. Android Studio sẽ tạo dự án của bạn bằng công cụ xây 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:

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

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

Một ứng dụng mẫu cho SDK Maps dành cho Android trên Wear OS có sẵn trên GitHub mà bạn có thể dùng làm điểm xuất phát khi tạo một ứng dụng cho thiết bị đeo. Mẫu này hướng dẫn bạn cách thiết lập một Google Map cơ bản trên Wear OS.