Thư viện tiện ích Maps SDK dành cho Android hỗ trợ Android
API
level 15 trở lên. Khi đặt mục tiêu xây dựng dự án, hãy đảm bảo bạn sử dụng phiên bản mới nhất
Cấp độ API của Android.
Chiến lược phát hành đĩa đơn
tham chiếu
có trên GitHub.
Bước 1. Cài đặt SDK Maps dành cho thư viện tiện ích Android
Hãy thêm phần phụ thuộc sau đây vào tệp build.gradle.kts của ứng dụng:
dependencies{// Utility Library for Maps SDK for Android// You do not need to add a separate dependency for the Maps SDK for Android// since this library builds in the compatible version of the Maps SDK.implementation("com.google.maps.android:android-maps-utils:3.14.0")}
Bước 2. (Không bắt buộc) Cài đặt SDK bản đồ cho thư viện tiện ích Android KTX
Thư viện tiện ích Android SDK bản đồ đi kèm với một tiện ích Kotlin tương ứng
(KTX). Thư viện này cung cấp các tính năng cho ngôn ngữ Kotlin, chẳng hạn như các hàm mở rộng, được đặt tên là
và đối số mặc định – để cho phép bạn viết Kotlin ngắn gọn và đặc trưng. Nếu bạn không
đang phát triển bằng Kotlin, bạn có thể bỏ qua bước này.
Để sử dụng thư viện này, hãy thêm phần phụ thuộc sau, ngoài phần phụ thuộc
Phần phụ thuộc android-maps-utils vào tệp build.gradle.kts của ứng dụng:
dependencies{// KTX for the Maps SDK for Android Utility Libraryimplementation("com.google.maps.android:maps-utils-ktx:5.2.0")}
Xem trang Maps KTX GitHub
để biết thêm thông tin về thư viện này.
Vì thư viện tiện ích là nguồn mở, bạn có thể tải xuống
android-maps-utils
vào máy của bạn để tuỳ chỉnh, xem ứng dụng minh hoạ hoặc nếu bạn chỉ muốn biết cách
thư viện hoạt động. Bạn có thể thực hiện việc này bằng cách
sao chép kho lưu trữ (nên dùng
để nhận các bản cập nhật tự động) hoặc
đang tải xuống
tệp zip. Nếu muốn tuỳ chỉnh thư viện, bạn nên
phát triển repo.
Kho lưu trữ bao gồm:
Một ứng dụng minh hoạ, trong thư mục demo.
Thư viện tiện ích, trong thư mục library.
Các tệp khác nhau chứa thông tin về giấy phép, người đóng góp và readme.
Cấu hình bản dựng Gradle, để sử dụng với Android Studio.
Chạy ứng dụng minh hoạ tiện ích
Kho lưu trữ GitHub cho thư viện tiện ích đi kèm một ứng dụng minh hoạ bao gồm mẫu
cách triển khai từng phần mềm tiện ích. Làm theo các bước sau để chạy ứng dụng minh hoạ trên
thiết bị Android của bạn.
Tải kho lưu trữ xuống bằng một trong các cách nêu trên.
Trong Android Studio, chọn File -> (Tệp ->) Mới -> Nhập dự án.
Duyệt qua và chọn (nhấp đúp) vào
Thư mục android-maps-utils được tạo khi bạn
đã sao chép thư viện tiện ích. Android Studio giờ đây sẽ tạo dự án.
Nếu bạn đang sử dụng thiết bị Android thay vì trình mô phỏng, hãy nhớ
bật chế độ nhà phát triển.
Sau đó, kết nối thiết bị Android với máy tính.
Thêm một dòng đơn vào local.properties như sau:
MAPS_API_KEY=YOUR_API_KEY
Trong đó YOUR_API_KEY là khoá API bạn nhận được như mô tả trong
Sử dụng khoá API.
Tạo và chạy ứng dụng minh hoạ.
Ứng dụng sẽ mở trên thiết bị Android, hiển thị một danh sách tiện ích
bao gồm cả tính năng phân cụm, poyutil, bản đồ nhiệt và nhiều tính năng khác. Bạn cũng có thể tìm thấy ứng dụng này trong
danh sách ứng dụng của bạn, dưới tên Bản minh hoạ tiện ích bản đồ.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[[["\u003cp\u003eThis page explains how to set up the Maps SDK for Android utility library and run its demo app, allowing you to utilize features like marker clustering and heatmaps.\u003c/p\u003e\n"],["\u003cp\u003eThe library supports Android API level 15 and above, requiring you to add a specific dependency to your app's \u003ccode\u003ebuild.gradle.kts\u003c/code\u003e file for implementation.\u003c/p\u003e\n"],["\u003cp\u003eAn optional Kotlin extensions (KTX) library provides Kotlin-specific features for more concise coding if you are developing in Kotlin.\u003c/p\u003e\n"],["\u003cp\u003eThe open-source nature of the library allows for customization by cloning or downloading the \u003ccode\u003eandroid-maps-utils\u003c/code\u003e repository from GitHub.\u003c/p\u003e\n"],["\u003cp\u003eYou can explore the functionalities of the library by running the demo app included in the repository, requiring steps like adding your API key and building the project in Android Studio.\u003c/p\u003e\n"]]],["To set up the Maps SDK for Android utility library, add the `android-maps-utils` dependency to your `build.gradle.kts` file. Optionally, include the `maps-utils-ktx` dependency for Kotlin features. The library, which supports Android API level 15 and above, is open-source and can be downloaded from GitHub. To run the included demo app, clone the repository, import the project into Android Studio, enable developer mode on your Android device, add your API key to `local.properties`, and then build and run the app.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/utility/setup \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/utility/setup \"View this page for the iOS platform docs.\")\n\nThis page describes how to set up the\n[Maps SDK for Android\nutility library](https://github.com/googlemaps/android-maps-utils), and to run the demo app included in the library.\n\nPrerequisites and notes\n\nThe Maps SDK for Android utility library supports Android\n[API\nlevel](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 15 and above. When setting your project build target, make sure you use the latest\nAndroid API level.\n\nThe\n[reference\ndocumentation](http://googlemaps.github.io/android-maps-utils/javadoc/) is available on GitHub.\n\nStep 1. Install the Maps SDK for Android utility library\n\nAdd the following dependency to your app's `build.gradle.kts` file: \n\n```carbon\ndependencies {\n\n\n // Utility Library for Maps SDK for Android\n // You do not need to add a separate dependency for the Maps SDK for Android\n // since this library builds in the compatible version of the Maps SDK.\n implementation(\"com.google.maps.android:android-maps-utils:3.14.0\")\n}\n```\n\nUse one of the utilities from the library, such as\n[marker\nclustering](/maps/documentation/android-sdk/utility/marker-clustering),\n[heatmaps](/maps/documentation/android-sdk/utility/heatmap), or\nthe [other\nutilities](/maps/documentation/android-sdk/utility).\n\nStep 2. (Optional) Install the Maps SDK for Android utility KTX library\n\nThe Maps SDK for Android utility library comes with a corresponding Kotlin extensions\n(KTX) library. This library provides Kotlin language features---such as extension functions, named\nand default arguments---to enable you to write concise and idiomatic Kotlin. If you are not\ndeveloping in Kotlin, you can skip this step.\n\nTo use this library, add the following dependency, in addition to the\n`android-maps-utils` dependency, to your app's `build.gradle.kts` file: \n\n```carbon\ndependencies {\n\n // KTX for the Maps SDK for Android Utility Library\n implementation(\"com.google.maps.android:maps-utils-ktx:5.2.0\")\n}\n```\n\nCheck out the [Maps KTX GitHub](https://github.com/googlemaps/android-maps-ktx) page\nfor additional information about this library.\n\nStep 3. View the Maps SDK for Android utility library source code\n\nSince the utility library is open source, you can download the\n[android-maps-utils](https://github.com/googlemaps/android-maps-utils)\nlibrary to your machine to customize it, view the demo app, or if you just want to understand how\nthe library works. You can do so by\n[cloning](https://github.com/googlemaps/android-maps-utils.git) the repo (recommended,\nto receive automatic updates) or\n[downloading\na zip file](https://github.com/googlemaps/android-maps-utils/archive/master.zip). If you want to customize the library, you should\n[fork the repo](https://help.github.com/articles/fork-a-repo).\n\nThe repository includes:\n\n- A demo application, in the `demo` directory.\n- The library of utilities, in the `library` directory.\n- Various files containing license, contributors, and readme information.\n- Gradle build configuration, for use with Android Studio.\n\nRun the utility demo app\n\nThe GitHub repository for the utility library ships with a demo app that includes sample\nimplementations of each utility. Follow these steps to run the demo app on\nyour Android device.\n\n1. Download the repository using one of the options mentioned above.\n2. In Android Studio, choose **File -\\\u003e New -\\\u003e Import Project**.\n3. Browse to and select (double-click) the **android-maps-utils** directory that was created when you cloned the utility library. Android Studio now builds the project.\n4. If you are using an Android device instead of an emulator, make sure to [enable developer mode](https://developer.android.com/tools/device.html#setting-up). Then attach the Android device to your computer.\n5. Add a single line to `local.properties` that looks like this:\n\n ```scdoc\n MAPS_API_KEY=YOUR_API_KEY\n ```\n\n Where \u003cvar translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e is the API key you obtained as described in\n [Using API Keys](/maps/documentation/android-sdk/get-api-key).\n6. Build and run the **demo** app.\n\nThe app should open on the Android device, displaying a list of utilities\nincluding clustering, poyutil, heatmap, and more. You can also find the app in\nyour app list, under the name **Maps Utils Demo**."]]
