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

Kho lưu trữ Maps SDK cho Android trên GitHub có các mẫu minh hoạ cách sử dụng Maps SDK cho Android trong ứng dụng Android.

Kho lưu trữ này 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 ứng dụng, thêm khoá API, xem bản minh hoạ và sử 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 bạn chạy ứng dụng mẫu, ứng dụng này sẽ hiển thị danh sách các mẫu có sẵn mà bạn có thể chạy trên thiết bị của riêng mình. Chọn một trong các lựa chọn. Ví dụ: nhấp vào Basic Map (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 rằng 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.

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

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

• Bản đồ cơ bản
• Điểm đánh dấu
• Điểm đánh dấu nâng cao
• Vị trí của tôi
• Sự kiện
• Đường đa giác
• Đa giác

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

Bạn phải có Git để chạy mẫu này cục bộ. Lệnh sau sẽ 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í mà 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 Mở. Android Studio sẽ tạo dự án của bạn bằng công cụ tạo 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 về tệp này, hãy xem bài viết Thêm khoá API vào dự án.
5. Lấy khoá API từ dự án của bạn khi bật Maps SDK cho Android.

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

7. 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 Maps SDK cho Android trên Wear OS có trên GitHub. Bạn có thể sử dụng ứng dụng này làm điểm xuất phát khi tạo ứng dụng cho thiết bị đeo. Mẫu này cho bạn biết cách thiết lập bản đồ Google cơ bản trên Wear OS.