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