اندروید
برنامه نمونه ApiDemos را اجرا کنید
برای اجرای برنامه نمونه ApiDemos، نمونه GitHub ( جاوا | Kotlin ) را ببینید و نسخه نمایشی CloudBasedMapStylingDemoActivity
( جاوا | Kotlin ) را مشاهده کنید.
می توانید یک نمونه برنامه جاوا و کاتلین پیدا کنید که نحوه استایل دادن به نقشه اندروید خود را از فضای ابری نشان می دهد.
مشکلات شناخته شده
هنگامی که برنامه شما به مشتریان تحویل داده شد، سبک های سفارشی برای نقشه ها با شناسه نقشه می توانند از Google Cloud Console به روز شوند. استایل های جدید تا چند ساعت دیگر در اپلیکیشن شما منعکس خواهند شد.
برای اطمینان از اینکه سبکهای سفارشی جدید فوراً برای اهداف آزمایشی نشان داده میشوند، دادههای برنامه را از دستگاه آزمایشی خود پاک کنید. برای اطلاعات بیشتر درباره پاک کردن دادهها از دستگاهتان، به راهنمای Android - آزاد کردن فضا مراجعه کنید.
توجه داشته باشید که تنظیمات ممکن است بر اساس تلفن متفاوت باشد. برای اطلاعات بیشتر، با سازنده دستگاه خود تماس بگیرید .
iOS
برنامه نمونه ApiDemos را اجرا کنید
برای اجرای برنامه نمونه ApiDemos، نمونه برنامه نقشه گوگل GitHub را ببینید و پروژه CloudBasedMapStylingViewController
(نمونه GitHub برای Swift | Objective-C ) را مشاهده کنید.
نسخه ی نمایشی CocoaPod یا GitHub با استایل ابری اختیاری
به جای شروع از ابتدا، میتوانید برنامه نمونه Objective-C ما را امتحان کنید که نشان میدهد چگونه نقشه iOS خود را از فضای ابری استایل کنید. برای جزئیات، نمونه Objective-C را ببینید.
برنامه آزمایشی بتا را بسازید
در Xcode، دکمه کامپایل را فشار دهید تا بسازید و سپس طرح فعلی را اجرا کنید. بیلد یک خطا ایجاد می کند و از شما می خواهد که کلید API خود را در فایل SDKDemoAPIKey.h
وارد کنید.
اگر هنوز کلید API ندارید، پروژهای را در Cloud Console راهاندازی کنید و با دنبال کردن دستورالعملها در دریافت کلید API، یک کلید API دریافت کنید. هنگام پیکربندی کلید در Cloud Console، میتوانید شناسه بسته برنامه خود را مشخص کنید تا مطمئن شوید که فقط برنامه شما میتواند از کلید استفاده کند. شناسه بسته پیشفرض برنامه نمونههای SDK com.example.GoogleMapsDemos
است.
فایل SDKDemoAPIKey.h
را ویرایش کنید و کلید API خود را در تعریف ثابت kAPIKey قرار دهید:
static NSString *const kAPIKey = @"YOUR_API_KEY";
اگر Xcode از شما خواست قفل فایل SDKDemoAPIKey.h
را برای ویرایش باز کنید، Unlock را انتخاب کنید.
خط زیر را حذف کنید:
```
#error Register for API Key and insert here.
```
پروژه را بسازید و اجرا کنید.
نسخه ی نمایشی نقشه یک ظاهر طراحی ابری
نسخه ی نمایشی CloudStyling
نحوه استایل دادن به نقشه را با استفاده از یک مجموعه سبک در Google Cloud Console نشان می دهد.
هنگامی که برنامه آزمایشی راه اندازی شد، روی نسخه نمایشی سفارشی سازی نقشه در بخش نمونه های بتا در بالای لیست کلیک کنید.
روی Style Map کلیک کنید تا تأثیر بارگیری شناسه های مختلف نقشه را ببینید.
می توانید سبک خود را نیز اضافه کنید ("Style Map" > "Add a new map ID ID") و به روز رسانی نقشه را با نقشه سبک سفارشی خود مشاهده کنید.
جاوا اسکریپت
این یک مثال اساسی از بارگیری یک نقشه سبک سفارشی با استفاده از شناسه نقشه است. در این مورد، Maps JavaScript به شناسه نقشه 8e0a97af9386fef
هنگام بارگیری نقشه ارجاع می دهد و به طور خودکار سبک نقشه مرتبط با آن شناسه نقشه را اعمال می کند.
TypeScript
function initMap(): void { new google.maps.Map( document.getElementById("map") as HTMLElement, { mapId: "8e0a97af9386fef", center: { lat: 48.85, lng: 2.35 }, zoom: 12, } as google.maps.MapOptions ); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
جاوا اسکریپت
function initMap() { new google.maps.Map(document.getElementById("map"), { mapId: "8e0a97af9386fef", center: { lat: 48.85, lng: 2.35 }, zoom: 12, }); } window.initMap = initMap;
Sample را امتحان کنید
Maps Static API
شناسه نقشه یک شناسه است که با یک سبک یا ویژگی خاص نقشه مرتبط است. یک سبک نقشه را پیکربندی کنید و آن را با شناسه نقشه در Google Cloud Console مرتبط کنید. سپس، هنگامی که به شناسه نقشه در کد خود اشاره می کنید، سبک نقشه مرتبط با آن در برنامه شما نمایش داده می شود. هر گونه بهروزرسانی سبک بعدی که ایجاد میکنید بهطور خودکار در برنامهتان ظاهر میشود، بدون اینکه نیازی به بهروزرسانی توسط مشتریانتان باشد.
اگر از طرحبندی نقشههای مبتنی بر ابر با نقشههای موجود استفاده میکنید که با پارامتر
style
سفارشی شده است، مطمئن شوید که آنها را حذف کردهاید تا از تضاد احتمالی با ویژگیهای آینده جلوگیری کنید.برای افزودن شناسه نقشه به نقشه جدید یا موجود که از یکی از APIهای وب ما استفاده می کند، پارامتر URL
map_id
را اضافه کرده و آن را به شناسه نقشه خود تنظیم کنید. این مثال اضافه کردن شناسه نقشه را با استفاده از Maps Static API به نقشه نشان میدهد.<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />