طرح 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 hex سفارشی‌سازی کنید. |
|
شناور | کدری خط پیرامونی را سفارشی‌سازی کنید، که در آن 0 شفاف و 1 کدر است. |
|
شناور | ضخامت خط پیرامونی را از محدوده ۰ تا ۸ سفارشی‌سازی کنید. |
برای اطلاعات بیشتر، به چندضلعی‌ها و چندخطی‌ها مراجعه کنید.
label حالت‌دهنده
جدول زیر همه سبک‌دهنده‌های برچسب دردسترس را فهرست می‌کند.
| Styler | تایپ کردن | شرح |
|---|---|---|
|
بولی | برای پنهان کردن برچسب عارضه نقشه، روی false تنظیم کنید. |
|
رشته | رنگ برچسب نوشتاری را با رشته هگز RGB سفارشی‌سازی کنید. |
|
شناور | ماتی برچسب نوشتار را سفارشی‌سازی کنید، که در آن ۰ شفاف و ۱ مات است. |
|
رشته | رنگ طرح کلی را با رشته RGB hex سفارشی‌سازی کنید. |
|
شناور | کدری خط پیرامونی را سفارشی‌سازی کنید، که در آن 0 شفاف و 1 کدر است. |
|
شناور | ضخامت خط پیرامونی را از محدوده ۰ تا ۸ سفارشی‌سازی کنید. |
|
رشته | رنگ سنجاق را با رشته هگز RGB سفارشی‌سازی کنید. |
|
رشته | رنگ گلیف (نماد) را در سنجاق با رشته RGB hex سفارشی‌سازی کنید. |
|
رشته | رنگ خط پیرامونی سنجاق را با رشته RGB hex سفارشی‌سازی کنید. |
برای اطلاعات بیشتر، به نمادها و برچسب‌های نوشتاری مراجعه کنید.
بزرگ‌نمایی‌های کلیدی
می‌توانید برای یک ویژگی، یک سبک واحد برای همه سطوح بزرگ‌نمایی کلیدی تنظیم کنید یا سبک‌های مختلفی را برای سطوح بزرگ‌نمایی کلیدی مختلف مشخص کنید. اگر فقط یک سبک ارائه دهید، از آن برای همه سطوح بزرگ‌نمایی کلیدی که از z0 شروع می‌شوند استفاده خواهد شد. اگر برای سطوح مختلف بزرگ‌نمایی کلیدی سبک ارائه دهید، سبک از آن سطح بزرگ‌نمایی تا سطح بعدی که تعریف کرده‌اید اعمال خواهد شد.
برای تنظیم سطح بزرگ‌نمایی کلیدی برای یک سبک، در ویژگی سبک‌ساز، سطح بزرگ‌نمایی کلیدی را از z0 تا z22 و سپس سفارشی‌سازی سبک‌ساز را تعریف کنید.
در مثال زیر، رنگ آب در سطوح بزرگ‌نمایی کلیدی ۰ تا ۵ سیاه است، در سطوح بزرگ‌نمایی کلیدی ۶ تا ۱۱ خاکستری تیره است، و از سطح بزرگ‌نمایی کلیدی ۱۲ خاکستری روشن است.
{
"id": "natural.water",
"geometry": {
"fillColor": {
"z0": "#000000",
"z6": "#666666",
"z12": "#cccccc"
}
}
}
برای اطلاعات بیشتر، سطوح بزرگ‌نمایی سبک را ببینید.
محدودیت‌ها
می‌توانید از JSON برای سبک‌بندی تقریباً همه چیز در کنسول Google Cloud استفاده کنید، به‌جز گزینه‌های زیر از منو تنظیمات نقشه:
- تراکم «مکان‌های جالب» را کنترل کنید.
- نمایش ساختمانها را (ردپا درمقابل سهبعدی) تغییر دهید.
- تغییر نمایش (مصور درمقابل استاندارد) نقاط دیدنی.
این گزینه‌های سطح نقشه برای ارائه صحیح به واکشی مجدد داده‌های کاشی نیاز دارند که ممکن است برای برخی موارد استفاده نامطلوب باشد.
برای این گزینه‌ها، باید اولویتتان را در منوِ تنظیمات نقشه انتخاب کنید.
چون این گزینه‌ها در سبک‌های صادرشده گنجانده نشده‌اند، باید هنگام وارد کردن سبک، دوباره در کنسول Google Cloud انتخاب شوند.