يتيح لك مخطّط 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 للحصول على نسخة رمادية من الخريطة. |
|
|
عنصر | بيانات عشوائية على شكل مفتاح/قيمة مضمّنة في تعريف النمط يمكنك استخدام هذا الحقل لتضمين محتوى غير مرتبط بالنمط. ولا يتم إرسال هذه البيانات إلى برامج الخرائط، مثل حزمة تطوير البرامج بالاستناد إلى بيانات JavaScript في "خرائط Google". |
|
عناصر قاعدة الأنماط
يصف هذا القسم السمات التي تحدّد عناصر قاعدة الأنماط في مصفوفة 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. |
|
سلسلة | خصِّص لون المضلّع أو الخط المتعدد باستخدام سلسلة سداسية عشرية بنموذج أحمر أخضر أزرق. |
|
عدد عائم | تخصيص مستوى التعتيم للمضلّع أو المتعدّد الخطوط، حيث 0 تعني شفاف و1 تعني معتم |
|
سلسلة | تخصيص لون المخطط التفصيلي باستخدام سلسلة سداسية عشرية RGB |
|
عدد عائم | تخصيص مستوى تعتيم المخطّط، حيث 0 يعني شفاف و1 يعني معتم |
|
عدد عائم | يمكنك تخصيص سمك المخطط التفصيلي من نطاق يتراوح بين 0 و8. |
لمزيد من المعلومات، يُرجى الاطّلاع على المضلّعات والخطوط المتعددة.
label أدوات التنسيق
يسرد الجدول التالي جميع أدوات تصميم التسميات المتاحة.
| Styler | النوع | الوصف |
|---|---|---|
|
قيمة منطقية | لإخفاء تصنيف عنصر على الخريطة، اضبط القيمة على false. |
|
سلسلة | تخصيص لون تصنيف النص باستخدام سلسلة سداسية عشرية لألوان الأحمر والأخضر والأزرق |
|
عدد عائم | تخصيص مستوى شفافية تصنيف النص، حيث 0 يعني شفاف و1 يعني معتم |
|
سلسلة | تخصيص لون المخطط التفصيلي باستخدام سلسلة سداسية عشرية RGB |
|
عدد عائم | تخصيص مستوى تعتيم المخطّط، حيث 0 يعني شفاف و1 يعني معتم |
|
عدد عائم | يمكنك تخصيص سمك المخطط التفصيلي من نطاق يتراوح بين 0 و8. |
|
سلسلة | خصِّص لون الدبوس باستخدام سلسلة سداسية عشرية RGB. |
|
سلسلة | تخصيص لون الشكل الرسومي (الرمز) داخل دبوس باستخدام سلسلة سداسية عشرية لألوان الأحمر والأخضر والأزرق |
|
سلسلة | خصِّص لون الخط المحيطي للدبوس باستخدام سلسلة سداسية عشرية RGB. |
لمزيد من المعلومات، يُرجى الاطّلاع على الرموز والتصنيفات النصية.
مستويات التكبير الرئيسية
يمكنك ضبط نمط واحد لميزة ما لجميع مستويات التكبير الرئيسية أو تحديد أنماط مختلفة لمستويات التكبير الرئيسية المختلفة. إذا قدّمت نمطًا واحدًا فقط، سيتم استخدامه مع جميع مستويات التكبير/التصغير الرئيسية بدءًا من z0. في حال توفير أنماط لمستويات التكبير الرئيسية المختلفة، سيتم تطبيق النمط من مستوى التكبير هذا إلى المستوى التالي الذي حدّدته.
لضبط مستوى التكبير الرئيسي لنمط، في سمة أداة التنسيق، حدِّد مستوى التكبير الرئيسي من z0 إلى z22 ثم تخصيص أداة التنسيق.
في المثال التالي، يكون لون المياه أسودًا من مستويات التكبير الرئيسية 0 إلى 5، ورماديًا داكنًا من مستويات التكبير الرئيسية 6 إلى 11، ورماديًا فاتحًا بدءًا من مستوى التكبير الرئيسي 12.
{
"id": "natural.water",
"geometry": {
"fillColor": {
"z0": "#000000",
"z6": "#666666",
"z12": "#cccccc"
}
}
}
لمزيد من المعلومات، اطّلِع على مستويات تكبير الأنماط.
القيود
يمكنك استخدام JSON لتصميم كل شيء تقريبًا في "وحدة تحكّم Google Cloud"، باستثناء الخيارات التالية من قائمة إعدادات الخريطة:
- التحكّم في كثافة "نقاط الاهتمام":
- تغيير طريقة عرض المباني (بصمات مقابل ثلاثية الأبعاد)
- تغيير طريقة عرض المعالم (رسومات توضيحية أو عادية)
تتطلّب خيارات الخريطة هذه إعادة جلب بيانات المربّعات من أجل عرضها بشكل صحيح، وهو ما قد يكون غير مرغوب فيه في بعض حالات الاستخدام.
بالنسبة إلى هذه الخيارات، عليك تحديد الإعدادات المفضّلة في قائمة إعدادات الخريطة.
بما أنّ هذه الخيارات غير مضمّنة في الأنماط التي يتم تصديرها، يجب إعادة تحديدها في Google Cloud Console عند استيراد نمط.