مرجع JSON لتصميم الخرائط باستخدام السحابة الإلكترونية

اختيار النظام الأساسي: Android iOS JavaScript Web Service

يتيح لك مخطّط JSON لتصميم الخرائط باستخدام السحابة الإلكترونية استخدام 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).

الإعدادات على المستوى الأعلى

تنطبق السمات الواردة في الجدول التالي على نمط الخريطة بالكامل.

الموقع النوع الوصف مثال

backgroundColor

سلسلة تخصيص لون خلفية تطبيق الخريطة باستخدام سلسلة سداسية عشرية بتنسيق ‎ #RRGGBB لا يتيح هذا الإعداد إجراء تغييرات على مستوى التعتيم. "#002211"

variant

"light"|"dark" حدِّد الوضع الفاتح أو الداكن. إذا لم يتم تحديدها، تكون القيمة التلقائية هي "فاتح". "light"

monochrome

قيمة منطقية لتفعيل وضع الألوان الأحادية، استخدِم true لعرض نسخة رمادية من الخريطة.

true

عناصر قواعد الأنماط

يوضّح هذا القسم السمات التي تحدّد عناصر قاعدة الأنماط في مصفوفة styles لتخصيص ميزات الخريطة. يجب أن يتكوّن كل كائن من كائنات قواعد الأنماط مما يلي:

  • موقع id
  • عنصر geometry أو label مع تحديد خصائص أداة التنسيق المرتبطة

id (ميزة الخريطة)

تحدّد السمة id عنصر الخريطة الذي سيتم تنسيقه. أسماء المواقع هي إصدارات camelcase من أسماء عناصر الخريطة في محرّر الأنماط.

تتضمّن عناصر الخريطة شجرة فئات. إذا حدّدت نوع عنصر رئيسي، مثل pointOfInterest، سيتم تطبيق الأنماط التي تحدّدها للعنصر الرئيسي على جميع العناصر الفرعية، مثل pointOfInterest.retail وpointOfInterest.lodging. لمزيد من التفاصيل، يُرجى الاطّلاع على تسلسل ميزات الخريطة.

قائمة بخصائص id المتاحة

في ما يلي سمات id المتاحة:

  • pointOfInterest
  • pointOfInterest.emergency
  • pointOfInterest.emergency.fire
  • pointOfInterest.emergency.hospital
  • pointOfInterest.emergency.pharmacy
  • pointOfInterest.emergency.police
  • pointOfInterest.entertainment
  • pointOfInterest.entertainment.arts
  • pointOfInterest.entertainment.casino
  • pointOfInterest.entertainment.cinema
  • pointOfInterest.entertainment.historic
  • pointOfInterest.entertainment.museum
  • pointOfInterest.entertainment.themePark
  • pointOfInterest.entertainment.touristAttraction
  • pointOfInterest.foodAndDrink
  • pointOfInterest.foodAndDrink.bar
  • pointOfInterest.foodAndDrink.cafe
  • pointOfInterest.foodAndDrink.restaurant
  • pointOfInterest.foodAndDrink.winery
  • pointOfInterest.landmark
  • pointOfInterest.lodging
  • pointOfInterest.recreation
  • pointOfInterest.recreation.beach
  • pointOfInterest.recreation.boating
  • pointOfInterest.recreation.fishing
  • pointOfInterest.recreation.golfCourse
  • pointOfInterest.recreation.hotSpring
  • pointOfInterest.recreation.natureReserve
  • pointOfInterest.recreation.park
  • pointOfInterest.recreation.peak
  • pointOfInterest.recreation.sportsComplex
  • pointOfInterest.recreation.sportsField
  • pointOfInterest.recreation.trailhead
  • pointOfInterest.recreation.zoo
  • pointOfInterest.retail
  • pointOfInterest.retail.grocery
  • pointOfInterest.retail.shopping
  • pointOfInterest.service
  • pointOfInterest.service.atm
  • pointOfInterest.service.bank
  • pointOfInterest.service.carRental
  • pointOfInterest.service.evCharging
  • pointOfInterest.service.gasStation
  • pointOfInterest.service.parkingLot
  • pointOfInterest.service.postOffice
  • pointOfInterest.service.restStop
  • pointOfInterest.service.restroom
  • pointOfInterest.transit
  • pointOfInterest.transit.airport
  • pointOfInterest.other
  • pointOfInterest.other.bridge
  • pointOfInterest.other.cemetery
  • pointOfInterest.other.government
  • pointOfInterest.other.library
  • pointOfInterest.other.military
  • pointOfInterest.other.placeOfWorship
  • pointOfInterest.other.school
  • pointOfInterest.other.townSquare
  • political
  • political.countryOrRegion
  • political.border
  • political.reservation
  • political.stateOrProvince
  • political.city
  • political.sublocality
  • political.neighborhood
  • political.landParcel
  • infrastructure
  • infrastructure.building
  • infrastructure.building.commercial
  • infrastructure.businessCorridor
  • infrastructure.roadNetwork
  • infrastructure.roadNetwork.noTraffic
  • infrastructure.roadNetwork.noTraffic.pedestrianMall
  • infrastructure.roadNetwork.noTraffic.trail
  • infrastructure.roadNetwork.noTraffic.trail.paved
  • infrastructure.roadNetwork.noTraffic.trail.unpaved
  • infrastructure.roadNetwork.parkingAisle
  • infrastructure.roadNetwork.ramp
  • infrastructure.roadNetwork.road
  • infrastructure.roadNetwork.road.arterial
  • infrastructure.roadNetwork.road.highway
  • infrastructure.roadNetwork.road.local
  • infrastructure.roadNetwork.road.noOutlet
  • infrastructure.roadNetwork.roadShield
  • infrastructure.roadNetwork.roadSign
  • infrastructure.roadNetwork.roadDetail
  • infrastructure.roadNetwork.roadDetail.surface
  • infrastructure.roadNetwork.roadDetail.crosswalk
  • infrastructure.roadNetwork.roadDetail.sidewalk
  • infrastructure.roadNetwork.roadDetail.intersection
  • infrastructure.railwayTrack
  • infrastructure.railwayTrack.commercial
  • infrastructure.railwayTrack.commuter
  • infrastructure.transitStation
  • infrastructure.transitStation.bicycleShare
  • infrastructure.transitStation.busStation
  • infrastructure.transitStation.ferryTerminal
  • infrastructure.transitStation.funicularStation
  • infrastructure.transitStation.gondolaStation
  • infrastructure.transitStation.monorail
  • infrastructure.transitStation.railStation
  • infrastructure.transitStation.railStation.subwayStation
  • infrastructure.transitStation.railStation.tramStation
  • infrastructure.urbanArea
  • natural
  • natural.continent
  • natural.archipelago
  • natural.island
  • natural.land
  • natural.land.landCover
  • natural.land.landCover.crops
  • natural.land.landCover.dryCrops
  • natural.land.landCover.forest
  • natural.land.landCover.ice
  • natural.land.landCover.sand
  • natural.land.landCover.shrub
  • natural.land.landCover.tundra
  • natural.water
  • natural.water.ocean
  • natural.water.lake
  • natural.water.river
  • natural.water.other
  • natural.base

العناصر

العناصر هي تقسيمات فرعية لميزة خريطة. على سبيل المثال، يتألف الطريق من الخط البياني (geometry) على الخريطة، بالإضافة إلى النص الذي يشير إلى اسمه (label).

تتوفّر العناصر التالية، ولكن يُرجى العِلم أنّ ميزة معيّنة في الخريطة قد تتوافق مع بعض العناصر أو كلها أو لا تتوافق مع أيّ منها:

  • geometry: يختار جميع العناصر الهندسية (مثل المضلّع والخط المتعدد) الخاصة بميزة الخريطة المحدّدة.
  • label: يختار جميع عناصر التصنيف (مثل النص والدبوس) الخاصة بميزة الخريطة المحدّدة.

أجهزة كي الملابس بالبخار

تتيح لك أدوات التنسيق تحديد قواعد التنسيق لكل عنصر من عناصر ميزة الخريطة.

على سبيل المثال، يمكنك ضبط نمط كل عنصر من عناصر البصمة الأرضية للمبنى على النحو التالي:

أمثلة على أدوات تصميم geometry لمبنى أمثلة على أدوات تصميم label لمبنى
تحديد ما إذا كان سيتم إخفاء مضلّع بصمة المبنى أو إظهاره على الخريطة تحديد ما إذا كان سيتم إخفاء تصنيف المبنى أو إظهاره
لون تعبئة المضلّع ودرجة التعتيم لون تعبئة النص ودرجة التعتيم
لون الحدود ودرجة التعتيم والعرض لون خط النص ودرجة التعتيم

يوضّح هذا القسم خيارات الأنماط المختلفة المتاحة للعنصرَين geometry وlabel.

geometry أدوات التنسيق

يسرد الجدول التالي جميع أدوات التنسيق الهندسية المتاحة.

Styler النوع الوصف

visible

قيمة منطقية لإخفاء المضلّع أو الخط المتعدد الخاص بعنصر خريطة، اضبط القيمة على false.

fillColor

سلسلة خصِّص لون المضلّع أو الخط المتعدد باستخدام سلسلة سداسية عشرية بنموذج أحمر أخضر أزرق.

fillOpacity

عدد عائم تخصيص مستوى تعتيم المضلّع أو الشكل المتعدّد الخطوط، حيث يشير 0 إلى الشفافية و1 إلى التعتيم

strokeColor

سلسلة يمكنك تخصيص لون المخطّط التفصيلي باستخدام سلسلة سداسية عشرية بنموذج أحمر أخضر أزرق.

strokeOpacity

عدد عائم تخصيص مستوى تعتيم المخطّط، حيث 0 يعني شفاف و1 يعني معتم

strokeWeight

عدد عائم يمكنك تخصيص سمك المخطّط التفصيلي من النطاق 0 إلى 8.

لمزيد من المعلومات، يُرجى الاطّلاع على المضلّعات والخطوط المتعددة.

label أدوات التنسيق

يسرد الجدول التالي جميع أدوات تصميم التسميات المتاحة.

Styler النوع الوصف

visible

قيمة منطقية لإخفاء تصنيف إحدى ميزات الخريطة، اضبط القيمة على false.

textFillColor

سلسلة تخصيص لون تصنيف النص باستخدام سلسلة سداسية عشرية لألوان الأحمر والأخضر والأزرق

textFillOpacity

عدد عائم تخصيص مستوى شفافية تصنيف النص، حيث 0 يعني شفاف و1 يعني معتم

textStrokeColor

سلسلة يمكنك تخصيص لون المخطّط التفصيلي باستخدام سلسلة سداسية عشرية بنموذج أحمر أخضر أزرق.

textStrokeOpacity

عدد عائم تخصيص مستوى تعتيم المخطّط، حيث 0 يعني شفاف و1 يعني معتم

textStrokeWeight

عدد عائم يمكنك تخصيص سمك المخطّط التفصيلي من النطاق 0 إلى 8.

pinFillColor

سلسلة تخصيص لون الدبوس باستخدام سلسلة سداسية عشرية بنظام RGB

لمزيد من المعلومات، يُرجى الاطّلاع على الرموز والتصنيفات النصية.

مستويات التكبير الرئيسية

يمكنك ضبط نمط واحد لميزة ما لجميع مستويات تكبير المفتاح أو تحديد أنماط مختلفة لمستويات تكبير المفتاح المختلفة. إذا قدّمت نمطًا واحدًا فقط، سيتم استخدامه مع جميع مستويات التكبير والتصغير بدءًا من z0. في حال توفير أنماط لمستويات تكبير/تصغير مختلفة، سيتم تطبيق النمط من مستوى التكبير/التصغير هذا إلى المستوى التالي الذي حدّدته.

لضبط مستوى تكبير/تصغير رئيسي لأحد الأنماط، حدِّد مستوى التكبير/التصغير الرئيسي من z0 إلى z22 في سمة أداة تصميم الخرائط، ثم حدِّد تخصيص أداة تصميم الخرائط.

في المثال التالي، يكون لون الماء أسودًا من مستويات التكبير والتصغير الرئيسية 0 إلى 5، ورماديًا داكنًا من مستويات التكبير والتصغير الرئيسية 6 إلى 11، ورماديًا فاتحًا بدءًا من مستوى التكبير والتصغير الرئيسي 12.

{   "id": "natural.water",   "geometry": {     "fillColor": {       "z0": "#000000",       "z6": "#666666",       "z12": "#cccccc"     }   } } 

لمزيد من المعلومات، اطّلِع على مستويات تكبير الأنماط.