يتيح لك مخطّط 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 Console، باستثناء الخيارات التالية من قائمة إعدادات الخريطة:
- التحكّم في كثافة "نقاط الاهتمام":
- تغيير طريقة عرض المباني (بصمات مقابل ثلاثية الأبعاد)
- تغيير طريقة عرض المعالم (رسومات توضيحية أو عادية)
تتطلّب خيارات مستوى الخريطة هذه إعادة جلب بيانات المربّعات من أجل عرضها بشكل صحيح، وهو ما قد يكون غير مرغوب فيه في بعض حالات الاستخدام.
بالنسبة إلى هذه الخيارات، عليك تحديد الإعداد المفضّل في قائمة إعدادات الخريطة.
بما أنّ هذه الخيارات غير مضمّنة في الأنماط التي يتم تصديرها، يجب إعادة تحديدها في Google Cloud Console عند استيراد نمط.