از شناسه های نقشه استفاده کنید
شناسه نقشه یک شناسه است که با یک سبک یا ویژگی خاص نقشه مرتبط است. یک سبک نقشه را پیکربندی کنید و آن را با شناسه نقشه در Google Cloud Console مرتبط کنید. سپس، هنگامی که به شناسه نقشه در کد خود اشاره می کنید، سبک نقشه مرتبط با آن در برنامه شما نمایش داده می شود. هر گونه بهروزرسانی سبک بعدی که ایجاد میکنید بهطور خودکار در برنامهتان ظاهر میشود، بدون اینکه نیازی به بهروزرسانی توسط مشتریانتان باشد.
پس از ایجاد، شناسههای نقشه با یک پروژه مرتبط میشوند و همچنین به یک پلتفرم (اندروید، iOS، جاوا اسکریپت) یا Maps Static API محدود میشوند.
برای ایجاد یا مدیریت هر شناسه نقشه در Cloud Console، باید نقش IAM مالک پروژه یا ویرایشگر پروژه را داشته باشید.
مجوزهای مورد نیاز
برای ایجاد یا مدیریت هر شناسه نقشه یا سبک نقشه در یک پروژه Google Cloud خاص، باید نقش مالک یا ویرایشگر IAM در پروژه را نگه دارید.
یک شناسه نقشه ایجاد کنید
شناسه نقشه یک شناسه منحصر به فرد است که یک نمونه از نقشه گوگل را نشان می دهد. میتوانید شناسههای نقشه ایجاد کنید و سبک مرتبط با شناسه نقشه را در هر زمان در کنسول Cloud بهروزرسانی کنید.
برای ایجاد شناسه نقشه:
- در Cloud Console، به صفحه مدیریت نقشه ها بروید.
- برای نمایش فرم Create New Map ID، Create New Map ID را انتخاب کنید.
در فرم، موارد زیر را انجام دهید:
- نام نقشه را مشخص کنید
- نوع یا پلت فرم نقشه را مشخص کنید.
- برای نقشه های جاوا اسکریپت، نوع نقشه شطرنجی یا برداری را انتخاب کنید.
- توضیحات نقشه را وارد کنید.
- برای نمایش شناسه نقشه جدید، Next را انتخاب کنید.
شناسه نقشه را به سبک نقشه مرتبط کنید
این دستورالعمل ها فرض می کنند که حداقل یک سبک نقشه موجود در پروژه شما وجود دارد.
- در Cloud Console، به صفحه مدیریت نقشه ها بروید.
- در این صفحه، شناسه نقشه موجود را از ستون نام نقشه انتخاب کنید.
- در پایین این فرم، یک سبک نقشه را از سبکهای نقشه مرتبط با فهرست کشویی Map ID انتخاب کنید.
- ذخیره را انتخاب کنید.
شناسه نقشه را به برنامه خود اضافه کنید
اندروید
شناسه نقشه خود را از طریق یک عنصر <fragment>
در فایل طرحبندی فعالیت، با استفاده از کلاس MapView
یا به صورت برنامهریزی با استفاده از کلاس GoogleMapOptions
اضافه کنید.
به عنوان مثال، فرض کنید یک شناسه نقشه ایجاد کرده اید که به عنوان مقدار رشته ای به نام map_id
در res/values/strings.xml
ذخیره می شود:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>
برای نقشههایی که از طریق عنصر <fragment>
در فایل طرحبندی فعالیت اضافه میشوند، همه قطعات نقشه که باید سبک سفارشی داشته باشند باید شناسه نقشه را در ویژگی map:mapId
مشخص کنند:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
class="com.google.android.gms.maps.SupportMapFragment"
…
map:mapId="@string/map_id" />
همچنین می توانید از ویژگی map:mapId
کلاس MapView
برای تعیین شناسه نقشه استفاده کنید:
<com.google.android.gms.maps.MapView
xmlns:android="http://schemas.android.com/apk/res/android"
....
map:mapId="@string/map_id" />
برای تعیین شناسه نقشه به صورت برنامهریزی، آن را با استفاده از کلاس GoogleMapOptions
به یک نمونه MapFragment
ارسال کنید:
جاوا
MapFragment mapFragment = MapFragment.newInstance(
new GoogleMapOptions()
.mapId(getResources().getString(R.string.map_id)));
کاتلین
val mapFragment = MapFragment.newInstance(
GoogleMapOptions()
.mapId(resources.getString(R.string.map_id))
)
در اندروید استودیو، برنامه خود را همانطور که به طور معمول انجام می دهید بسازید و اجرا کنید. سبکهای سفارشی، همانطور که در مرحله اول پیکربندی شدهاند، برای همه نقشههای دارای شناسه اعمال خواهند شد.
iOS
برای نمونه سازی نقشه با استفاده از شناسه نقشه، موارد زیر را انجام دهید:
- یک
GMSMapID
با رشته شناسه نقشه از Cloud Console ایجاد کنید. - یک
GMSMapView
ایجاد کنید که شناسه نقشه ای را که ایجاد کرده اید مشخص کنید.
سویفت
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "<YOUR MAP ID>")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView
هدف-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
longitude:-122.336471
zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"<YOUR MAP ID>"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
اگر از شناسه نقشه خود استفاده میکنید، میتوانید شناسه نقشه خود را در کنسول Cloud طوری تنظیم کنید که در هر زمان خواستید سبک جدیدی داشته باشد و این سبک به طور خودکار در نمای نقشه شما و کاربران در عرض حدود شش ساعت منعکس میشود.
اگر میخواهید فوراً تغییرات را مشاهده کنید، میتوانید با خروج از برنامه، برنامه خود را ببندید و مجدداً راهاندازی کنید، برنامه را از لیست برنامههای اخیراً استفاده شده خارج کنید و سپس آن را دوباره باز کنید. سپس نقشه به روز شده قابل مشاهده خواهد بود.
جاوا اسکریپت
برای ایجاد نقشه با شناسه نقشه در کد برنامه:
اگر در حال حاضر نقشه خود را با کد JSON تعبیه شده سفارشی می کنید، ویژگی
styles
از شیMapOptions
خود حذف کنید. در غیر این صورت، این مرحله را رها کنید.با استفاده از ویژگی
mapId
یک شناسه نقشه به نقشه اضافه کنید. به عنوان مثال:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Maps Static
برای افزودن شناسه نقشه به نقشه جدید یا موجود که از یکی از 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" />
ویژگی های موجود هنگام استفاده از شناسه های نقشه
طرحبندی نقشههای مبتنی بر ابر : با استفاده از Google Cloud Console، نقشههای خود را سبک، سفارشیسازی و مدیریت کنید.
موجود بر روی همه پلتفرم ها (Android، JavaScript، iOS و Maps Static API)
نقشه های برداری : نقشه ای متشکل از کاشی های مبتنی بر برداری که در زمان بارگذاری در سمت مشتری با استفاده از WebGL ترسیم می شوند.
در جاوا اسکریپت موجود است