باستخدام خيارات النمط، يمكنك تخصيص طريقة تقديم أنماط "خرائط Google" العادية وتغيير العرض المرئي للميزات، مثل الطرق والمتنزهات والأنشطة التجارية وغيرها من نقاط الاهتمام. وبالإضافة إلى تغيير نمط هذه الميزات، يمكنك إخفاء الميزات بالكامل. وهذا يعني أنه يمكنك التأكيد على أجزاء معيّنة من الخريطة أو جعل الخريطة مكمّلة لنمط الصفحة المحيطة.
أمثلة
يحوِّل بيان نمط JSON التالي جميع ميزات الخريطة إلى اللون الرمادي، ثم يلون هندسة الطريق الرئيسية باللون الأزرق، ويخفي تصنيفات المناظر الطبيعية تمامًا:
[ { "featureType": "all", "stylers": [ { "color": "#C0C0C0" } ] },{ "featureType": "road.arterial", "elementType": "geometry", "stylers": [ { "color": "#CCFFFF" } ] },{ "featureType": "landscape", "elementType": "labels", "stylers": [ { "visibility": "off" } ] } ]
كائن JSON
يتكوّن تعريف نمط JSON من العناصر التالية:
- featureType (اختيارية) - الميزات المطلوب اختيارها لتعديل النمط هذا. الميزات هي خصائص جغرافية على الخريطة، بما في ذلك الطرق والمتنزهات والمسطحات المائية وغيرها. إذا لم تحدّد ميزة، يتم اختيار جميع الميزات.
- elementType (اختيارية) - سمة الميزة المحددة التي يجب اختيارها. العناصر هي أجزاء فرعية من الميزة، بما في ذلك التصنيفات والهندسة. إذا لم تحدّد عنصرًا، يتم اختيار جميع عناصر الميزة.
- stylers - القواعد التي يجب تطبيقها على الميزات والعناصر المحدّدة. تشير أنماط الأنماط إلى لون الميزة ورؤيتها ووزنها. يمكنك تطبيق مصمم نمط واحد أو أكثر على الميزة.
لتحديد نمط، يجب دمج مجموعة من أداتَي الاختيار featureType
وelementType
وstylers
في مصفوفة نمط. يمكنك استهداف أي مجموعة من الميزات في مصفوفة واحدة. ومع ذلك،
يكون عدد الأنماط التي يمكنك تطبيقها في وقت واحد محدودًا. وإذا كانت مصفوفة النمط الخاصة بك تتجاوز الحد الأقصى لعدد الأحرف، لن يتم تطبيق أي نمط.
يحتوي باقي هذه الصفحة على مزيد من المعلومات حول الميزات والعناصر والتصميمات.
featureType
يحدِّد مقتطف JSON التالي جميع الطرق على الخريطة:
{ "featureType": "road" }
الميزات أو أنواع الميزات هي خصائص جغرافية على الخريطة، بما في ذلك الطرق والمنتزهات والمسطحات المائية والأنشطة التجارية وغيرها.
تشكِّل الميزات شجرة فئات، مع تحديد all
على أنّها الجذر. إذا لم تحدد ميزة، يتم تحديد جميع الميزات.
يؤدي تحديد ميزة all
إلى التأثير نفسه.
تحتوي بعض الميزات على ميزات ثانوية تحدّدها باستخدام علامة النقطة. على سبيل المثال، landscape.natural
أو road.local
. أما إذا حددت الميزة الرئيسية فقط، مثل road
، فسيتم تطبيق الأنماط التي يتم تحديدها للعنصر الرئيسي على جميع عناصرها الثانوية، مثل road.local
وroad.highway
.
يُرجى العِلم بأنّ الميزات الرئيسية قد تتضمّن بعض العناصر التي لم يتم تضمينها في كل الميزات الفرعية.
تتوفّر الميزات التالية:
- تختار
all
(الخيار التلقائي) كل الميزات. - يختار
administrative
جميع المناطق الإدارية. ويؤثر التنسيق في تصنيفات المناطق الإدارية فقط، وليس على الحدود الجغرافية أو التعبئة.- تختار
administrative.country
البلدان. - يختار تطبيق "
administrative.land_parcel
" قطع الأراضي. - يحدد
administrative.locality
المناطق المحلية. - يتم اختيار الأحياء من قِبل "
administrative.neighborhood
". - يتمّ اختيار المقاطعات من خلال
administrative.province
.
- تختار
- يختار
landscape
جميع المناظر الطبيعية.- يختار
landscape.man_made
العناصر من صنع الإنسان، مثل المباني والبنى الأخرى. - يختار تطبيق
landscape.natural
الميزات الطبيعية، مثل الجبال والأنهار والصحاري والأنهار الجليدية. - يختار
landscape.natural.landcover
ميزات الغطاء الأرضي، والمواد المادية التي تغطي سطح الأرض، مثل الغابات والأراضي العشبية والأراضي الرطبة والأراضي العارية. - يختار
landscape.natural.terrain
ميزات التضاريس لسطح الأرض، مثل الارتفاع والانحدار والاتجاه.
- يختار
- يختار
poi
جميع نقاط الاهتمام.- يختار
poi.attraction
المعالم السياحية. - تم اختيار أنشطة تجارية من قِبل
poi.business
. - يختار
poi.government
المباني الحكومية. - يختار
poi.medical
خدمات الطوارئ، بما في ذلك المستشفيات والصيدليات والشرطة والأطباء وغير ذلك. - تم اختيار حدائق من قِبل
poi.park
. - يختار
poi.place_of_worship
أماكن العبادة، بما في ذلك الكنائس والمعابد والمساجد وغيرها. - تم اختيار المؤسسات التعليمية من قِبل "
poi.school
". - يختار
poi.sports_complex
المجمّعات الرياضية.
- يختار
- يختار
road
كل الطرق.- يختار
road.arterial
الطرق الرئيسية. - يختار
road.highway
الطرق السريعة. - يختار
road.highway.controlled_access
الطرق السريعة التي يتم التحكّم فيها. - يختار
road.local
الطرق المحلية.
- يختار
- يختار
transit
جميع محطات وخطوط النقل العام.- يختار
transit.line
خطوط النقل العام. - يختار
transit.station
جميع محطات النقل العام. - يتم اختيار المطارات من قِبل
transit.station.airport
. - يختار
transit.station.bus
محطات الحافلات. - يختار
transit.station.rail
محطات السكك الحديدية.
- يختار
- يختار
water
مسطحات مائية.
elementType
يحدد مقتطف JSON التالي التصنيفات لجميع الطرق المحلية:
{ "featureType": "road.local", "elementType": "labels" }
العناصر هي أقسام فرعية للميزة. تتألف الطريق، على سبيل المثال، من الخط الرسومي (الهندسة) على الخريطة، بالإضافة إلى النص الذي يشير إلى اسمها (تصنيف).
تتوفّر العناصر التالية، ولكن يُرجى العِلم أنّ ميزة معيّنة قد لا تتيح أيًا من هذه العناصر أو بعض منها أو جميعها:
- يؤدي اختيار
all
(تلقائيًا) إلى اختيار جميع عناصر الميزة المحددة. - يختار
geometry
جميع العناصر الهندسية للميزة المحددة.- تختار دالة
geometry.fill
تعبئة الهندسة البرمجية للميزة فقط. - يختار
geometry.stroke
فقط سُمك الخط الهندسي للميزة.
- تختار دالة
- يختار
labels
التصنيفات النصية المرتبطة بالميزة المحددة.- لا يختار
labels.icon
سوى الرمز المعروض ضمن تصنيف العنصر. - يختار
labels.text
نص التصنيف فقط. - يختار
labels.text.fill
تعبئة التصنيف فقط. ويتم عادةً عرض تعبئة التصنيف كمخطط ملون يحيط بنص التصنيف. - يختار
labels.text.stroke
ضغط نص التصنيف فقط.
- لا يختار
stylers
الأنماط هي خيارات تنسيق يمكنك تطبيقها على ميزات وعناصر الخريطة.
يعرض مقتطف JSON التالي ميزة باللون الأخضر الزاهي باستخدام قيمة نموذج أحمر أخضر أزرق:
"stylers": [ { "color": "#99FF33" } ]
يزيل هذا المقتطف كل الكثافة من لون الميزة، بغض النظر عن لون البداية. التأثير هو عرض الميزة بتدرج الرمادي:
"stylers": [ { "saturation": -100 } ]
يخفي هذا المقتطف ميزةً تمامًا:
"stylers": [ { "visibility": "off" } ]
تتوفر خيارات النمط التالية:
hue
(سلسلة سداسية عشرية بتنسيق RGB#RRGGBB
) تشير إلى اللون الأساسي.ملاحظة: يؤدي هذا الخيار إلى ضبط تدرُّج اللون مع الحفاظ على تشبُّع اللون والإضاءة المحدَّدين في نمط Google التلقائي (أو في خيارات النمط الأخرى التي تحدّدها على الخريطة). ويكون اللون الناتج مرتبطًا بنمط الخريطة الأساسية. إذا أجرى Google أي تغييرات على نمط الخريطة الأساسي، ستؤثر التغييرات في ميزات الخريطة التي تم تصميمها بنمط
hue
. من الأفضل استخدام تصميمcolor
المطلق إذا أمكن.lightness
(قيمة النقطة العائمة بين-100
و100
) تشير إلى النسبة المئوية للتغيير في سطوع العنصر. تزيد القيم السالبة من درجة التعتيم (حيث تشير القيمة -100 إلى اللون الأسود) بينما تزيد القيم الموجبة من درجة السطوع (حيث تحدد +100 اللون الأبيض).ملاحظة: يضبط هذا الخيار مستوى الإضاءة مع الحفاظ على تشبُّع اللون وتدرج اللون المحددَين في نمط Google التلقائي (أو في خيارات النمط الأخرى التي تحدّدها على الخريطة). ويكون اللون الناتج مرتبطًا بنمط الخريطة الأساسية. إذا أجرى Google أي تغييرات على نمط الخريطة الأساسي، ستؤثر التغييرات في ميزات الخريطة التي تم تصميمها بنمط
lightness
. وبالتالي، من الأفضل استخدام مصمِّم إطاراتcolor
الكامل إذا أمكن.- تشير قيمة
saturation
(قيمة النقطة العائمة بين-100
و100
) إلى النسبة المئوية للتغيّر في كثافة اللون الأساسي المطلوب تطبيقه على العنصر.ملاحظة: يؤدي هذا الخيار إلى ضبط التشبع مع الحفاظ على تدرُّج اللون والإضاءة المحدَّدين في نمط Google التلقائي (أو في خيارات النمط الأخرى التي تحدّدها على الخريطة). ويكون اللون الناتج مرتبطًا بنمط الخريطة الأساسية. إذا أجرى Google أي تغييرات على نمط الخريطة الأساسي، ستؤثر التغييرات في ميزات الخريطة التي تم تصميمها بنمط
saturation
. من الأفضل استخدام مصفّف شعرcolor
الكامل إن أمكن. - وتشير قيمة النقطة
gamma
(قيمة النقطة العائمة بين0.01
و10.0
، حيث لا تستخدم1.0
القيمة أي تصحيح) إلى مقدار تصحيح غاما المطلوب تطبيقه على العنصر. تعدّل تصحيحات غاما سطوع الألوان بطريقة غير خطية، بدون التأثير في القيم البيضاء أو السوداء. يتم عادةً استخدام تصحيح غاما لتعديل تباين العناصر المتعددة. على سبيل المثال، يمكنك تعديل غاما لزيادة التباين بين حواف العناصر وداخلها أو تقليله.ملاحظة: يضبط هذا الخيار درجة الإضاءة حسب نمط Google التلقائي، وذلك باستخدام منحنى غاما. إذا أجرى محرّك بحث Google أي تغييرات على نمط الخريطة الأساسي، ستؤثر التغييرات في ميزات الخريطة التي تم تصميمها بنمط
gamma
. من الأفضل استخدام تصميمcolor
المطلق إذا أمكن. - تعمل القيمة
invert_lightness
(إذا كانتtrue
) على عكس مستوى الإضاءة الحالي. ويكون هذا الإجراء مفيدًا على سبيل المثال للتبديل سريعًا إلى خريطة أكثر قتامة بنص أبيض.ملاحظة: يعكس هذا الخيار نمط Google التلقائي. إذا أجرى محرّك بحث Google أي تغييرات على نمط الخريطة الأساسي، ستؤثر التغييرات في ميزات الخريطة التي تم تصميمها بنمط
invert_lightness
. من الأفضل استخدام مصفّف شعرcolor
الكامل إن أمكن. - تشير السمة
visibility
(on
أوoff
أوsimplified
) إلى ما إذا كان العنصر سيظهر على الخريطة وطريقة عرضه. تزيل إمكانية رؤيةsimplified
بعض ميزات النمط من الميزات المتأثرة. على سبيل المثال، يتم تبسيط الطرق إلى خطوط أكثر سمكًا بدون مخططات تفصيلية، بينما تفقد المتنزهات نص التصنيف الخاص بها ولكنها تحتفظ برمز التصنيف. - تحدّد
color
(سلسلة سداسية عشرية بتنسيق RGB#RRGGBB
) لون الميزة. weight
(قيمة عدد صحيح أكبر من أو تساوي صفر) يحدّد وزن العنصر بالبكسل. قد يؤدي ضبط الوزن على قيمة عالية إلى اقتصاصه بالقرب من حدود المربّعات.
يتم تطبيق قواعد النمط بالترتيب الذي تحدّده. لا تدمج عمليات متعددة في عملية نمط واحد. بدلاً من ذلك، يمكنك تحديد كل عملية باعتبارها إدخالاً منفصلاً في صفيف النمط.
ملاحظة: الترتيب مهم، لأن بعض العمليات ليست إبدالية. العناصر و/أو العناصر التي تم تعديلها من خلال عمليات الأنماط (عادةً) لها أنماط حالية. تعمل العمليات على تلك الأنماط الحالية، إن وُجدت.
نموذج تدرج اللون والتشبع والإضاءة
تستخدم الخرائط ذات التصميم نماذج تدرج اللون وتشبّع اللون والإضاءة (HSL) للإشارة إلى اللون ضمن عمليات المصمم. يشير تدرج اللون إلى اللون الأساسي، في حين يشير التشبع إلى كثافة ذلك اللون، ويشير الإضاءة إلى المقدار النسبي للأبيض أو الأسود في اللون المكون.
تعمل ميزة تصحيح أشعة جاما على تعديل درجة الإضاءة فوق مساحة اللون، بشكل عام
لزيادة التباين أو تقليله. إضافةً إلى ذلك، يحدّد نموذج HSL اللون
في المساحة الإحداثية حيث تشير السمة hue
إلى الاتجاه
في بكرة الألوان، في حين يشير التشبع والإضاءة إلى الاتساع
على المحاور المختلفة. يتم قياس تدرجات اللون ضمن مساحة اللون نموذج أحمر أخضر أزرق (RGB)، وهو ما يشبه معظم مساحات الألوان الأحمر والأخضر والأزرق، باستثناء أنّ ظلال اللونين الأبيض والأسود غير موجودة.
يأخذ hue
قيمة لون سداسية عشرية في HTML، إلّا أنّه لا يستخدم هذه القيمة إلا لتحديد اللون الأساسي، أي اتجاهه حول عجلة الألوان، وليس تشبُّع اللون أو سطوعه، وهو ما يتم الإشارة إليه بشكل منفصل عن طريق تغيّر النسبة المئوية.
على سبيل المثال، يمكنك تحديد تدرُّج اللون الأخضر الخالص على النحو التالي: hue:0x00ff00
أو hue:0x000100
. وكلا اللونين متطابقين. تشير كلتا القيمتين إلى اللون الأخضر النقي في نموذج ألوان HSL.
عجلة ألوان نموذج أحمر أخضر أزرق
أمّا قيم hue
للنموذج الأحمر والأخضر والأزرق، والتي تتكوّن من أجزاء متساوية باللونين الأحمر والأخضر والأزرق،
فلا تشير إلى تدرج اللون، لأنّ أيًّا من هذه القيم لا يشير إلى اتجاه في
مساحة إحداثي HSL. تشمل الأمثلة "#000000" (أسود) و"#FFFFFF" (أبيض)
وجميع الظلال الخالصة للرمادي. للإشارة إلى الأسود أو الأبيض أو الرمادي، يجب
إزالة saturation
بالكامل (ضبط القيمة على -100
)
وتعديل lightness
بدلاً من ذلك.
بالإضافة إلى ذلك، عند تعديل الميزات الحالية التي تتضمّن
ألوانًا، لن يؤدي تغيير قيمة مثل hue
إلى تغيير
saturation
أو lightness
الحالية.