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