تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

مرجع 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"
    }
  }
}

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

القيود

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

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

مرجع JSON لتصميم الخرائط باستخدام السحابة الإلكترونية تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الاطّلاع على مثال على تعريف نمط JSON

كائن JSON

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

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

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

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

العناصر

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

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

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

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

القيود

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

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

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

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

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