خرائط ذات نمط

يمكنك تخصيص طريقة عرض خريطة Google العادية من خلال تطبيق أنماطك الخاصة عند استخدام Maps Static API. يمكنك تغيير طريقة العرض المرئية للميزات، مثل الطرق والحدائق والمناطق المكتظة بالسكان ونقاط الاهتمام الأخرى. يمكنك تغيير لونها أو نمطها لإبراز محتوى معيّن، استكمال المحتوى المحيط على الصفحة أو حتى إخفاء الميزات تمامًا.

أمثلة

يعرض المثال التالي خريطة لبروكلين في الولايات المتحدة مع أنماط لتلوين الطرق المحلية باللون الأخضر الساطع والمناطق السكنية باللون الأسود. ويعكس أيضًا درجة سطوع التصنيفات، ما يجعلها تبرز بشكل أفضل على خلفية داكنة. يُرجى العِلم أنّ هذا المثال العملي يستخدم ترميز عناوين URL:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=15&center=Brooklyn&style=feature:road.local%7Celement:geometry%7Ccolor:0x00ff00&style=feature:landscape%7Celement:geometry.fill%7Ccolor:0x000000&style=element:labels%7Cinvert_lightness:true&style=feature:road.arterial%7Celement:labels%7Cinvert_lightness:false&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
 خريطة ذات تصميم خاص لمدينة بروكلين

يستخدم المثال التالي عمليات التنسيق والتبسيطات لـ تقريب مظهر أطلس الطرق في الولايات المتحدة:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=12&center=Chicago&format=png&style=feature:road.highway%7Celement:geometry%7Cvisibility:simplified%7Ccolor:0xc280e9&style=feature:transit.line%7Cvisibility:simplified%7Ccolor:0xbababa&style=feature:road.highway%7Celement:labels.text.stroke%7Cvisibility:on%7Ccolor:0xb06eba&style=feature:road.highway%7Celement:labels.text.fill%7Cvisibility:on%7Ccolor:0xffffff&key=YOUR_API_KEY&signature=DITIGAL_SIGNATURE
 نمط خريطة أطلس الطرقات في الولايات المتحدة

بنية النمط

لإنشاء خريطة منمّقة مخصّصة، عليك تضمين مَعلمة style واحدة أو أكثر في عنوان URL للطلب.

قد يحتوي كل إعلان style على الوسيطات التالية، مفصولة بأحرف الأنابيب ("|"):

  • feature (اختيارية): تشير إلى الميزات التي يجب اختيارها لتعديل هذا النمط. تشمل الميزات العناصر الموجودة على الخريطة، مثل الطرق، الحدائق أو نقاط الاهتمام الأخرى. إذا لم يتم تضمين وسيطة feature argument ، يتم تطبيق النمط المحدّد على جميع الميزات.
  • element (اختيارية): تشير إلى عناصر الميزة المحدّدة التي يجب اختيارها لتعديل هذا النمط. العناصر هي خصائص الميزة، مثل الشكل الهندسي أو التصنيفات. إذا لم يتم تضمين element وسيطة، يتم تطبيق النمط على جميع العناصر للميزة المحدّدة.
  • مجموعة من قواعد الأنماط (إلزامية) التي يجب تطبيقها على الميزات والعناصر المحدّدة . تطبّق واجهة برمجة التطبيقات القواعد بالترتيب الذي تظهر به في إعلان style. يمكنك تضمين أي عدد من القواعد، ضمن القيود العادية لطول عنوان URL في Maps Static API.
style=feature:myFeatureArgument|element:myElementArgument|myRule1:myRule1Argument|myRule2:myRule2Argument

الميزات

يلوّن إعلان style التالي جميع الطرق على الخريطة: 

style=feature:road|color:0xffffff

في ما يلي بعض خيارات الميزات الشائعة:

  • feature:all (تلقائي): يختار جميع ميزات الخريطة.
  • feature:road: يختار جميع الطرق على الخريطة.
  • feature:road.local: يختار جميع الطرق المحلية.

الميزات أو أنواع الميزات هي خصائص جغرافية على الخريطة، بما في ذلك الطرق والحدائق والمسطحات المائية والأنشطة التجارية وغير ذلك.

تشكّل الميزات شجرة فئات، حيث تكون 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: يختار المسطحات المائية.

العناصر

يلوّن إعلان style التالي تصنيفات جميع الطرق المحلية:

style=feature:road.local|element:labels|color:0xffffff

العناصر هي تقسيمات فرعية للميزة. على سبيل المثال، يتكوّن الطريق من الخط المرئي (الشكل الهندسي) على الخريطة، بالإضافة إلى النص الذي يشير إلى اسمه (تصنيف).

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

يتغيّر لونَا fill وstroke لنص التصنيف استنادًا إلى مستوى التكبير/التصغير. للحصول على تجربة متّسقة على مستوى التكبير/التصغير، عليك دائمًا تحديد كل من fill وstroke.

  • all (تلقائي): يختار جميع عناصر الميزة المحدّدة.
  • geometry: يختار جميع العناصر الهندسية للميزة المحدّدة.
    • geometry.fill: يختار تعبئة الشكل الهندسي للميزة فقط.
    • geometry.stroke: يختار خط الشكل الهندسي للميزة فقط.
  • labels: يختار التصنيفات النصية المرتبطة بالميزة المحدّدة.
    • labels.icon: يختار الرمز المعروض ضمن تصنيف الميزة فقط.
    • labels.text: يختار نص التصنيف فقط.
    • labels.text.fill: يختار تعبئة التصنيف فقط. عادةً ما يتم عرض تعبئة التصنيف على شكل خط ملوّن يحيط بنص التصنيف.
    • labels.text.stroke: يختار خط نص التصنيف فقط.

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

قواعد الأنماط هي خيارات التنسيق التي يتم تطبيقها على الميزات والعناصر المحدّدة ضمن كل style إعلان.

يطبّق إعلان style التالي قاعدتَي نمط على الـ طرق على الخريطة. تطبّق القاعدة الأولى لونًا على الطرق. وتُبسّط القاعدة الثانية طريقة عرض الطرق، ما يجعلها تتضمّن خطوطًا أرق من دون خطوط خارجية: 

style=feature:road|color:0xffffff|visibility:simplified

يجب أن يحتوي كل إعلان style على عملية واحدة أو أكثر مفصولة باستخدام حرف الأنابيب ("|"). تحدّد كل عملية قيمة الوسيطة باستخدام حرف النقطتَين (":")، ويتم تطبيق جميع العمليات على الخيار بالترتيب الذي تحدّده.

تتوفّر خيارات الأنماط التالية:

  • 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، وهي مشابهة لمعظم مساحات ألوان RGB، باستثناء عدم توفّر درجات اللونَين الأبيض و الأسود.

نموذج درجة اللون والتشبّع والإضاءة

بينما تأخذ hue قيمة لون ست عشري بتنسيق HTML، فإنّها تستخدم هذه القيمة فقط لتحديد اللون الأساسي، أي اتجاهه حول عجلة الألوان، وليس تشبع اللون أو الإضاءة، اللذين يتم الإشارة إليهما بشكل منفصل كتغييرات مئوية.

على سبيل المثال، يمكنك تحديد درجة اللون الأخضر النقي على النحو التالي: hue:0x00ff00 أو hue:0x000100. درجتا اللون متطابقتان. تشير كلتا القيمتَين إلى اللون الأخضر النقي في نموذج ألوان HSL.

عجلة ألوان RGB

لا تشير قيم hue في RGB التي تتكوّن من أجزاء متساوية من الأحمر والأخضر والأزرق لا تشير إلى درجة لون، لأنّ أيًا من هذه القيم لا يشير إلى اتجاه في مساحة إحداثيات HSL. تشمل الأمثلة "#000000" (أسود) و"#FFFFFF" (أبيض) و جميع درجات اللون الرمادي النقية. للإشارة إلى الأسود أو الأبيض أو الرمادي، عليك إزالة كل saturation (ضبط القيمة على -100) و تعديل lightness بدلاً من ذلك.

بالإضافة إلى ذلك، عند تعديل الميزات الحالية التي تتضمّن نظام ألوان ، لا يؤدي تغيير قيمة مثل hue إلى تغيير saturation أو lightness الحاليَين.