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

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

هذا المنتج أو الميزة تجريبيان (ما قبل التوفر للجمهور العام). قد يكون الدعم المقدّم للمنتجات والميزات في مرحلة ما قبل التوفّر للجمهور العام محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات هنا متوافقة مع الإصدارات الأخرى من هذه المرحلة. تخضع عروض مرحلة ما قبل التوفّر للجمهور العام لبنود الخدمة المحدّدة في "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

يتيح لك مخطّط 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	سلسلة	تخصيص لون الدبوس باستخدام سلسلة سداسية عشرية بتنسيق أحمر وأخضر وأزرق

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

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

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

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

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

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

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

القيود

يمكنك استخدام JSON لتصميم كل العناصر تقريبًا في Google Cloud Console، باستثناء الميزات التالية من قائمة إعدادات الخريطة:

• التحكّم في كثافة "نقاط الاهتمام":
• تغيير نمط المباني
• تغيير نمط المعالم

لاستخدام هذه الميزات، عليك تحديد إعداداتك المفضّلة في قائمة إعدادات الخريطة.