طرحواره JSON برای سبک‌پردازی نقشه بااستفاده از فضای ابری به شما امکان می‌دهد از JSON برای سفارشی‌سازی نقشه‌ها استفاده کنید، درست همان‌طور که ازطریق رابط ویرایشگر سبک این کار را انجام می‌دهید. این سند طرح JSON و نحوه ایجاد اعلان‌های سبک JSON را شرح می‌دهد.
برای آشنایی با نحوه ویرایش سبک نقشه بااستفاده از JSON در ویرایشگر سبک، یا وارد کردن و صادر کردن سبک نقشه، به استفاده از JSON با سبک‌پردازی نقشه بااستفاده از فضای ابری مراجعه کنید.
دیدن نمونه‌ای از بیانیه سبک JSON
اعلامیه سبک JSON زیر رنگ پس‌زمینه را تنظیم می‌کند و سپس سبک‌هایی را برای مکان‌های جالب، پارک‌ها، ویژگی‌های آب تعریف می‌کند و برچسب‌های مکان‌های غذا و نوشیدنی را پنهان می‌کند.
{
"variant": "light",
"styles": [
{
"id": "natural.land",
"geometry": {
"fillColor": "#f7e3f7"
}
},
{
"id": "natural.water",
"geometry": {
"fillColor": "#d4b2ff"
},
"label": {
"textFillColor": "#3d2163",
"textStrokeColor": "#f0e1ff"
}
},
{
"id": "pointOfInterest",
"label": {
"pinFillColor": "#e0349a",
"textFillColor": "#a11e6e",
"textStrokeColor": "#ffd9f0"
}
},
{
"id": "pointOfInterest.emergency.hospital",
"geometry": {
"fillColor": "#ffe3e3"
}
},
{
"id": "pointOfInterest.foodAndDrink",
"label": {
"visible": false
}
},
{
"id": "pointOfInterest.recreation.park",
"geometry": {
"fillColor": "#f9b9d2"
}
}
]
}
شیء JSON
اعلام سبک JSON شامل یک شیء سطح بالا و آرایه‌ای از قوانین سبک است.
- دارایی‌های سطح بالا (اختیاری) - تنظیمات سبک جهانی مانند
backgroundColorوvariant. styles- آرایه‌ای از اشیای قانون سبک، که می‌تواند شامل موارد زیر باشد:id- ویژگی نقشه برای انتخاب این اصلاح سبک (مثلاًpointOfInterest.recreation.park).geometry(اختیاری) - عناصر هندسی ویژگی نقشه و قوانین سبک برای اعمال کردن (برای نمونه،fillColor).label(اختیاری) - نوشتار یا برچسب سنجاق ویژگی نقشه و قوانین سبک برای اعمال کردن (برای نمونه،textStrokeColor).
ویژگی‌های سطح بالا
ویژگی‌های جدول زیر برای کل سبک نقشه اعمال می‌شود.
| دارایی | تایپ کردن | شرح | مثال |
|---|---|---|---|
|
رشته | رنگ پس‌زمینه برنامه نقشه را بااستفاده از رشته هگز #RRGGBB سفارشی‌سازی کنید. این تنظیم از تغییرات کدورت پشتیبانی نمی‌کند. | "#002211" |
|
"light"|"dark" | حالت روشن یا تاریک را مشخص کنید. اگر مشخص نشده باشد، پیش‌فرض «روشن» است. | «light» |
|
بولی | برای فعال کردن تک‌رنگی، از true برای نسخه خاکستری نقشه استفاده کنید. |
|
|
شیء | داده‌های کلید-مقدار اختیاری که در تعریف سبک گنجانده شده است. می‌توانید از این فیلد برای گنجاندن محتوای غیرمرتبط با سبک درباره سبک استفاده کنید. این داده‌ها به کارخواه‌های نقشه مانند کیت توسعه نرم‌افزار جاوا اسکریپت Maps ارسال نمی‌شود. |
|
اشیای قانون سبک
این بخش ویژگی‌هایی را توصیف می‌کند که اشیای قانون سبک را در آرایه styles برای سفارشی‌سازی عارضه‌های نقشه تعریف می‌کنند. هر شیء قانون سبک باید شامل موارد زیر باشد:
-
idدارایی. - عنصر
geometryیاlabelبا دارایی‌های سبک‌دهنده منسوب تعریف‌شده.
id (عارضه نقشه)
دارایی id ویژگی نقشه را برای سبک‌دهی مشخص می‌کند. نام‌های ویژگی
نسخه‌های camelcase نام‌های عارضه نقشه در ویرایشگر سبک هستند.
عارضه‌های نقشه درخت دسته‌بندی را تشکیل می‌دهند. اگر نوع عارضه والد را مشخص کنید،
مثلاً pointOfInterest، سبک‌هایی که برای والد مشخص می‌کنید برای همه
فرزندان آن، مثلاً pointOfInterest.retail و pointOfInterest.lodging، اعمال می‌شود.
برای جزئیات، به سلسله مراتب عارضه‌های نقشه مراجعه کنید.
فهرست دارایی‌های id دردسترس
دارایی‌های id دردسترس به‌شرح زیر است:
pointOfInterestpointOfInterest.emergencypointOfInterest.emergency.firepointOfInterest.emergency.hospitalpointOfInterest.emergency.pharmacypointOfInterest.emergency.policepointOfInterest.entertainmentpointOfInterest.entertainment.artspointOfInterest.entertainment.casinopointOfInterest.entertainment.cinemapointOfInterest.entertainment.historicpointOfInterest.entertainment.museumpointOfInterest.entertainment.themeParkpointOfInterest.entertainment.touristAttractionpointOfInterest.foodAndDrinkpointOfInterest.foodAndDrink.barpointOfInterest.foodAndDrink.cafepointOfInterest.foodAndDrink.restaurantpointOfInterest.foodAndDrink.winerypointOfInterest.landmarkpointOfInterest.lodgingpointOfInterest.recreationpointOfInterest.recreation.beachpointOfInterest.recreation.boatingpointOfInterest.recreation.fishingpointOfInterest.recreation.golfCoursepointOfInterest.recreation.hotSpringpointOfInterest.recreation.natureReservepointOfInterest.recreation.parkpointOfInterest.recreation.peakpointOfInterest.recreation.sportsComplexpointOfInterest.recreation.sportsFieldpointOfInterest.recreation.trailheadpointOfInterest.recreation.zoopointOfInterest.retailpointOfInterest.retail.grocerypointOfInterest.retail.shoppingpointOfInterest.servicepointOfInterest.service.atmpointOfInterest.service.bankpointOfInterest.service.carRentalpointOfInterest.service.evChargingpointOfInterest.service.gasStationpointOfInterest.service.parkingLotpointOfInterest.service.postOfficepointOfInterest.service.restStoppointOfInterest.service.restroompointOfInterest.transitpointOfInterest.transit.airportpointOfInterest.otherpointOfInterest.other.bridgepointOfInterest.other.cemeterypointOfInterest.other.governmentpointOfInterest.other.librarypointOfInterest.other.militarypointOfInterest.other.placeOfWorshippointOfInterest.other.schoolpointOfInterest.other.townSquarepoliticalpolitical.countryOrRegionpolitical.borderpolitical.reservationpolitical.stateOrProvincepolitical.citypolitical.sublocalitypolitical.neighborhoodpolitical.landParcelinfrastructureinfrastructure.buildinginfrastructure.building.commercialinfrastructure.businessCorridorinfrastructure.roadNetworkinfrastructure.roadNetwork.noTrafficinfrastructure.roadNetwork.noTraffic.pedestrianMallinfrastructure.roadNetwork.noTraffic.trailinfrastructure.roadNetwork.noTraffic.trail.pavedinfrastructure.roadNetwork.noTraffic.trail.unpavedinfrastructure.roadNetwork.parkingAisleinfrastructure.roadNetwork.rampinfrastructure.roadNetwork.roadinfrastructure.roadNetwork.road.arterialinfrastructure.roadNetwork.road.highwayinfrastructure.roadNetwork.road.localinfrastructure.roadNetwork.road.noOutletinfrastructure.roadNetwork.roadShieldinfrastructure.roadNetwork.roadSigninfrastructure.roadNetwork.roadDetailinfrastructure.roadNetwork.roadDetail.surfaceinfrastructure.roadNetwork.roadDetail.crosswalkinfrastructure.roadNetwork.roadDetail.sidewalkinfrastructure.roadNetwork.roadDetail.intersectioninfrastructure.railwayTrackinfrastructure.railwayTrack.commercialinfrastructure.railwayTrack.commuterinfrastructure.transitStationinfrastructure.transitStation.bicycleShareinfrastructure.transitStation.busStationinfrastructure.transitStation.ferryTerminalinfrastructure.transitStation.funicularStationinfrastructure.transitStation.gondolaStationinfrastructure.transitStation.monorailinfrastructure.transitStation.railStationinfrastructure.transitStation.railStation.subwayStationinfrastructure.transitStation.railStation.tramStationinfrastructure.urbanAreanaturalnatural.continentnatural.archipelagonatural.islandnatural.landnatural.land.landCovernatural.land.landCover.cropsnatural.land.landCover.dryCropsnatural.land.landCover.forestnatural.land.landCover.icenatural.land.landCover.sandnatural.land.landCover.shrubnatural.land.landCover.tundranatural.waternatural.water.oceannatural.water.lakenatural.water.rivernatural.water.othernatural.base
عناصر
عناصر بخش‌های فرعی عارضه نقشه هستند. برای مثال، یک جاده
شامل خط گرافیکی (geometry) روی نقشه و همچنین نوشتاری است که
نام آن را نشان می‌دهد (label).
عناصر زیر دردسترس هستند، اما توجه داشته باشید که یک ویژگی خاص نقشه ممکن است از هیچ‌یک، برخی، یا همه عناصر پشتیبانی کند:
geometry: همه عناصر هندسی (مثلاً چندضلعی، چندخطی) ویژگی نقشه مشخص‌شده را انتخاب می‌کند.label: همه عناصر برچسب (برای نمونه، نوشتار، سنجاق) ویژگی نقشه مشخص‌شده را انتخاب می‌کند.
دستگاه مراقبت از لباس
سبک‌دهنده‌ها روشی است که قوانین سبک خود را برای هر عنصر ویژگی نقشه تعریف می‌کنید.
برای مثال، برای ردپای ساختمان می‌توانید هر عنصر را به‌صورت زیر سبک‌بندی کنید:
نمونه geometry سبک‌دهنده برای ساختمان |
نمونه label سبک‌دهنده برای ساختمان |
|---|---|
| اینکه چندضلعی سطح اشغال ساختمان در نقشه پنهان شود یا نشان داده شود. | برچسب ساختمان پنهان یا نشان داده شود. |
| رنگ و ماتی پرکننده چندضلعی. | رنگ و ماتی پرکننده نوشتار. |
| رنگ، ماتی، و عرض حاشیه. | رنگ و ماتی خط پیرامونی متن. |
این بخش گزینه‌های مختلف سبک را که برای عناصر
geometry و label دردسترس است شرح می‌دهد.
geometry حالت‌دهنده
جدول زیر همه سبک‌سازهای هندسی دردسترس را فهرست می‌کند.
| Styler | تایپ کردن | شرح |
|---|---|---|
|
بولی | برای پنهان کردن چندضلعی یا چندخطی ویژگی نقشه، روی false تنظیم کنید. |
|
رشته | رنگ چندضلعی یا چندخطی را با رشته هگز RGB سفارشی‌سازی کنید. |
|
شناور | شفافیت چندضلعی یا چندخطی را سفارشی‌سازی کنید، که در آن ۰ شفاف و ۱ مات است. |
|
رشته | رنگ طرح کلی را با رشته هگز RGB سفارشی‌سازی کنید. |
|
شناور | شفافیت طرح کلی را سفارشی‌سازی کنید، که در آن ۰ شفاف و ۱ مات است. |
|
شناور | ضخامت خط پیرامونی را از محدوده ۰ تا ۸ سفارشی‌سازی کنید. |
برای اطلاعات بیشتر، به چندضلعی‌ها و چندخطی‌ها مراجعه کنید.
label حالت‌دهنده
جدول زیر همه سبک‌دهنده‌های برچسب دردسترس را فهرست می‌کند.
| Styler | تایپ کردن | شرح |
|---|---|---|
|
بولی | برای پنهان کردن برچسب عارضه نقشه، روی false تنظیم کنید. |
|
رشته | رنگ برچسب نوشتاری را با رشته هگز RGB سفارشی‌سازی کنید. |
|
شناور | ماتی برچسب نوشتاری را سفارشی‌سازی کنید، که در آن ۰ شفاف و ۱ مات است. |
|
رشته | رنگ طرح کلی را با رشته هگز RGB سفارشی‌سازی کنید. |
|
شناور | شفافیت طرح کلی را سفارشی‌سازی کنید، که در آن ۰ شفاف و ۱ مات است. |
|
شناور | ضخامت طرح کلی را از محدوده ۰ تا ۸ سفارشی‌سازی کنید. |
|
رشته | رنگ سنجاق را با رشته هگز RGB سفارشی‌سازی کنید. |
|
رشته | رنگ گلیف (نماد) را در سنجاق با رشته هگز RGB سفارشی‌سازی کنید. |
|
رشته | رنگ خط پیرامونی سنجاق را با رشته RGB hex سفارشی‌سازی کنید. |
برای اطلاعات بیشتر، به نمادها و برچسب‌های نوشتاری مراجعه کنید.
بزرگ‌نمایی‌های کلیدی
می‌توانید برای یک ویژگی، یک سبک واحد برای همه سطوح بزرگ‌نمایی کلیدی تنظیم کنید یا سبک‌های مختلفی را برای سطوح بزرگ‌نمایی کلیدی مختلف مشخص کنید. اگر فقط یک سبک ارائه دهید، این سبک برای همه سطوح زوم کلیدی از z0 استفاده خواهد شد. اگر برای سطوح مختلف کلیدزوم سبک ارائه دهید، سبک از آن سطح زوم تا سطح بعدی که تعریف کرده‌اید اعمال خواهد شد.
برای تنظیم سطح بزرگ‌نمایی کلیدی برای یک سبک، در ویژگی سبک‌ساز، سطح بزرگ‌نمایی کلیدی را از z0 تا z22 و سپس سفارشی‌سازی سبک‌ساز را تعریف کنید.
در مثال زیر، رنگ آب در سطوح کلیدزوم ۰ تا ۵ سیاه، در سطوح کلیدزوم ۶ تا ۱۱ خاکستری تیره، و از سطح کلیدزوم ۱۲ به بعد خاکستری روشن است.
{
"id": "natural.water",
"geometry": {
"fillColor": {
"z0": "#000000",
"z6": "#666666",
"z12": "#cccccc"
}
}
}
برای اطلاعات بیشتر، سطوح بزرگ‌نمایی سبک را ببینید.
محدودیت‌ها
می‌توانید از JSON برای سبک‌بندی تقریباً همه چیز در کنسول Google Cloud استفاده کنید، به‌جز گزینه‌های زیر از منو تنظیمات نقشه:
- تراکم «نقاط موردعلاقه» را کنترل کنید.
- نمایش ساختمانها را (ردپا درمقابل سهبعدی) تغییر دهید.
- تغییر نمایش (مصور دربرابر استاندارد) مکان‌های دیدنی.
این گزینه‌های سطح نقشه برای ارائه صحیح به واکشی مجدد داده‌های کاشی نیاز دارند که ممکن است برای برخی‌از موارد استفاده نامطلوب باشد.
برای این گزینه‌ها، باید اولویتتان را در منوِ تنظیمات نقشه انتخاب کنید.
چون این گزینه‌ها در سبک‌های صادرشده گنجانده نشده‌اند، باید هنگام وارد کردن سبک، دوباره در کنسول Google Cloud انتخاب شوند.