يتيح لك مخطّط 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". | "light" |
|
قيمة منطقية | لتفعيل الوضع الأحادي اللون، استخدِم true لعرض إصدار باللون الرمادي من الخريطة. |
|
|
عنصر | بيانات عشوائية على شكل أزواج من المفاتيح والقيم مضمّنة في تعريف النمط يمكنك استخدام هذا الحقل لتضمين محتوى غير مرتبط بالنمط عن النمط. لا يتم إرسال هذه البيانات إلى عملاء الخرائط، مثل حزمة تطوير البرامج (SDK) لخرائط JavaScript. |
|
عناصر قواعد الأنماط
يصف هذا القسم الخصائص التي تحدّد عناصر قواعد الأنماط في مصفوفة 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
يسرد الجدول التالي جميع أدوات التنسيق الهندسية المتاحة.
| أداة التنسيق | النوع | الوصف |
|---|---|---|
|
قيمة منطقية | لإخفاء مضلّع أو شكل متعدّد الخطوط لعنصر على الخريطة، اضبط القيمة على false. |
|
سلسلة | تخصيص لون المضلّع أو الخط المتعدد باستخدام سلسلة سداسية عشرية بتنسيق RGB |
|
float | تخصيص درجة تعتيم المضلّع أو الخط المتعدد، حيث تكون القيمة 0 شفافة والقيمة 1 معتمة |
|
سلسلة | تخصيص لون المخطّط باستخدام سلسلة سداسية عشرية بتنسيق RGB |
|
float | تخصيص درجة تعتيم المخطّط، حيث تكون القيمة 0 شفافة والقيمة 1 معتمة |
|
float | تخصيص سُمك المخطّط من نطاق يتراوح بين 0 و8 |
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة المضلّعات والخطوط المتعددة.
أدوات تنسيق label
يسرد الجدول التالي جميع أدوات تنسيق التصنيفات المتاحة.
| أداة التنسيق | النوع | الوصف |
|---|---|---|
|
قيمة منطقية | لإخفاء تصنيف عنصر على الخريطة، اضبط القيمة على false. |
|
سلسلة | تخصيص لون تصنيف النص باستخدام سلسلة سداسية عشرية بتنسيق RGB |
|
float | تخصيص درجة تعتيم تصنيف النص، حيث تكون القيمة 0 شفافة والقيمة 1 معتمة |
|
سلسلة | تخصيص لون المخطّط باستخدام سلسلة سداسية عشرية بتنسيق RGB |
|
float | تخصيص درجة تعتيم المخطّط، حيث تكون القيمة 0 شفافة والقيمة 1 معتمة |
|
float | تخصيص سُمك المخطّط من نطاق يتراوح بين 0 و8 |
|
سلسلة | تخصيص لون الدبوس باستخدام سلسلة سداسية عشرية بتنسيق RGB |
|
سلسلة | تخصيص لون الرسم (الرمز) داخل الدبوس باستخدام سلسلة سداسية عشرية بتنسيق 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 عند استيراد نمط.