طرح 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» |
|
بولی | برای فعال کردن تک‌رنگ، از 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 انتخاب شوند.