يتيح لك مخطّط 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 عند استيراد نمط.