Maps SDK برای کد نمونه اندروید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پلتفرم را انتخاب کنید: Android iOS JavaScript مخزن Maps SDK for Android در GitHub شامل نمونه هایی است که استفاده از Maps SDK for Android را در برنامه اندروید شما نشان می دهد.
این مخزن شامل برنامه ApiDemos است، یک برنامه نمونه که به شما امکان می دهد نمونه ها را از یک برنامه اندرویدی بسازید و اجرا کنید. برنامه را وارد کنید و بسازید، کلید API خود را اضافه کنید، نسخه آزمایشی را مشاهده کنید و از کد نمونه ارائه شده به عنوان نقطه شروع برنامه خود استفاده کنید.
هنگامی که برنامه نمونه را اجرا می کنید، لیستی از نمونه های موجود را نشان می دهد که می توانید در دستگاه خود اجرا کنید. یکی از گزینه ها را انتخاب کنید. برای مثال، روی Basic Map کلیک کنید.
عیب‌یابی: اگر برنامه نمونه با موفقیت اجرا شد اما نقشه‌ای را مشاهده نکردید، بررسی کنید که کلید API خود را به فایل مانیفست برنامه اضافه کرده‌اید، همانطور که در استفاده از کلیدهای API توضیح داده شده است.
Maps SDK for Android لیست نمونه برنامه
نمونه فعالیت‌های کلیدی موجود در Maps SDK برای برنامه Android ApiDemos در زیر فهرست شده‌اند و برای ارجاع سریع در صفحات پیوند داده می‌شوند. برای مشاهده لیست کامل نمونه های موجود به پوشه Kotlin یا Java مراجعه کنید.
نمونه ها را شبیه سازی کرده و اجرا کنید
Git برای اجرای این نمونه به صورت محلی مورد نیاز است. دستور زیر مخزن نمونه برنامه را شبیه سازی می کند.
git clone git@github.com:googlemaps-samples/android-samples.git
نمونه پروژه را به اندروید استودیو وارد کنید:
- در Android Studio، File > New > Import Project را انتخاب کنید.
به مکانی که مخزن را در آن ذخیره کرده اید بروید و دایرکتوری پروژه را برای Kotlin یا Java انتخاب کنید:
- Kotlin :
PATH-REPO /android-samples/ApiDemos/kotlin - جاوا :
PATH-REPO /android-samples/ApiDemos/java
- Open را انتخاب کنید. Android Studio پروژه شما را با استفاده از ابزار ساخت Gradle می سازد.
- یک فایل
secrets.properties خالی در دایرکتوری مشابه فایل local.properties پروژه خود ایجاد کنید. برای اطلاعات بیشتر در مورد این فایل، به افزودن کلید API خود به پروژه مراجعه کنید. - با فعال کردن Maps SDK for Android، یک کلید API از پروژه خود دریافت کنید .
رشته زیر را به secrets.properties اضافه کنید و مقدار YOUR_API_KEY را با مقدار کلید API خود جایگزین کنید:
MAPS_API_KEY=YOUR_API_KEY
- برنامه را اجرا کنید.
نمونه برنامه برای نقشه ها در Wear OS
یک برنامه نمونه برای Maps SDK برای Android در سیستم‌عامل Wear در GitHub موجود است که می‌توانید هنگام ساختن یک برنامه پوشیدنی از آن به عنوان نقطه شروع استفاده کنید. این نمونه به شما نشان می‌دهد که چگونه یک Google Map اولیه را در Wear OS تنظیم کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis page provides access to the Maps SDK for Android sample code and apps, including a comprehensive ApiDemos app containing various map feature examples.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can clone the sample repository from GitHub, import it into Android Studio, add their API key, and run the app to explore different map functionalities.\u003c/p\u003e\n"],["\u003cp\u003eThe ApiDemos app showcases key features such as basic maps, markers, events, polylines, polygons, and My Location, with code samples readily available for use.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting guidance is provided if the map doesn't display, directing users to verify their API key configuration.\u003c/p\u003e\n"],["\u003cp\u003eA separate sample app specifically for Wear OS is available on GitHub, demonstrating how to integrate Google Maps into wearable applications.\u003c/p\u003e\n"]]],["The Maps SDK for Android samples are available on GitHub. To use them, clone the repository, import the ApiDemos project into Android Studio (either Kotlin or Java), and add your API key to the `secrets.properties` file. Run the app to view a list of samples like Basic Map, Markers, and Polylines. A separate Wear OS sample is also available on GitHub, showing basic map setup for wearable apps. Ensure your API key is correctly added to the app manifest if you encounter map display issues.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/examples \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/examples \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/examples \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nThe Maps SDK for Android repository on [GitHub](https://github.com/googlemaps-samples/android-samples)\nincludes samples illustrating the use of the Maps SDK for Android in\nyour Android app.\n\nThe repository contains the [ApiDemos](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos) app, a sample app that lets\nyou build and run the samples from a single Android app. Import and build the\napp, add your API key, view the demo, and use the sample code supplied as a\nstarting point for your app.\n\nWhen you run the sample app, it displays a list of available samples that you\ncan run on your own device. Select one of the options. For example, click\n**Basic Map**.\n\n**Troubleshooting:** If the sample app runs successfully but you don't see a\nmap, check that you've added your API key to the app's manifest file, as\ndescribed in [Using API Keys](/maps/documentation/android-sdk/get-api-key).\n\nMaps SDK for Android sample app list\n\nKey sample activities contained in the Maps SDK for Android\n[ApiDemos](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos) app are listed below and reproduced at the linked pages\nfor quick reference. See the [Kotlin](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos/kotlin/app/src/main/java/com/example/kotlindemos) or [Java](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos/java/app/src/main/java/com/example/mapdemo)\nfolder for the full list of available samples.\n\n- [Basic map](/maps/documentation/android-sdk/examples/basic-map)\n- [Markers](/maps/documentation/android-sdk/examples/marker)\n- [Advanced markers](/maps/documentation/android-sdk/examples/advanced-marker)\n- [My Location](/maps/documentation/android-sdk/examples/my-location)\n- [Events](/maps/documentation/android-sdk/examples/events)\n- [Polylines](/maps/documentation/android-sdk/examples/polyline)\n- [Polygons](/maps/documentation/android-sdk/examples/polygon)\n\nClone and run the samples\n\nGit is required to run this sample locally. The following command clones the sample\napplication repository. \n\n```\ngit clone git@github.com:googlemaps-samples/android-samples.git\n```\n\nImport the sample project into Android Studio:\n\n1. In Android Studio, select **File \\\u003e New \\\u003e Import Project**.\n2. Go to the location where you saved the repository and select the project directory for\n Kotlin or Java:\n\n - **Kotlin** : \u003cvar translate=\"no\"\u003ePATH-REPO\u003c/var\u003e`/android-samples/ApiDemos/kotlin`\n - **Java** : \u003cvar translate=\"no\"\u003ePATH-REPO\u003c/var\u003e`/android-samples/ApiDemos/java`\n3. Select **Open**. Android Studio builds your project, using the Gradle build tool.\n4. Create a blank `secrets.properties` file in the same directory as your project's `local.properties` file. For more information about this file, see [Add your API key to the project](/maps/documentation/android-sdk/config#step_3_add_your_api_key_to_the_project).\n5. [Get an API key](/maps/documentation/android-sdk/get-api-key) from your project with the [Maps SDK for Android enabled](/maps/documentation/android-sdk/cloud-setup#enabling-apis).\n6. Add the following string to `secrets.properties`, replacing **YOUR_API_KEY** with the value of\n your API key:\n\n ```scdoc\n MAPS_API_KEY=YOUR_API_KEY\n ```\n7. Run the app.\n\nSample app for maps on Wear OS\n\nA sample app for Maps SDK for Android on Wear OS is\navailable on [GitHub](https://github.com/googlemaps-samples/android-samples/tree/main/WearOS), which you can use as a starting point when\nbuilding a wearable app. The sample shows you how to set up a basic Google Map\non Wear OS."]]
