البدء

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

المقدمة

تعرض واجهة برمجة تطبيقات الخرائط الثابتة صورة (إما GIF أو PNG أو JPEG) استجابة لطلب HTTP عبر عنوان URL. لكل طلب، يمكنك تحديد موقع الخريطة، وحجم الصورة، ومستوى التكبير/التصغير، ونوع الخريطة، وموضع محدّدات المواقع الاختيارية في المواقع على الخريطة. يمكنك أيضًا تصنيف العلامات باستخدام أحرف أبجدية رقمية.

يتم تضمين صورة واجهة برمجة التطبيقات الثابتة للخرائط في سمة src للعلامة <img>، أو ما يعادلها في لغات البرمجة الأخرى.

يوضح هذا المستند التنسيق المطلوب لعناوين URL الثابتة في "خرائط Google" والمعلمات المتاحة. كما يشير أيضًا إلى بعض النصائح والحيل في تحديد عناوين URL.

قبل البدء

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

قبل البدء في تطوير API للخرائط الثابتة، راجع متطلبات المصادقة (تحتاج إلى مفتاح واجهة برمجة التطبيقات) ومعلومات استخدام واجهة برمجة التطبيقات والفوترة (تحتاج إلى تمكين الفوترة في مشروعك).

معلمات عناوين URL

يجب أن يكون عنوان URL لواجهة برمجة التطبيقات الثابتة للخرائط على النحو التالي:

https://maps.googleapis.com/maps/api/staticmap?parameters

إذا تم الوصول إلى موقعك الإلكتروني عبر HTTPS، عليك تحميل صور "واجهة برمجة التطبيقات الثابتة للخرائط" عبر HTTPS أيضًا لتجنُّب تنبيهات الأمان في المتصفّح. ويُنصح أيضًا باستخدام بروتوكول HTTPS إذا كانت طلباتك تتضمّن معلومات حساسة للمستخدم، مثل الموقع الجغرافي للمستخدم:

https://maps.googleapis.com/maps/api/staticmap?parameters

سواء كنت تستخدم HTTP أو HTTPS، تكون بعض معلمات عناوين URL مطلوبة في حين أن بعضها اختياري. وكما هو معتاد في عناوين URL، يتم فصل جميع المعلمات باستخدام رمز العطف اللاتيني (&). ويتم سرد قائمة المعلمات وقيمها المحتملة في هذا المستند.

تحدد API للخرائط الثابتة صور الخريطة باستخدام معلمات عناوين URL التالية:

معلمات الموقع الجغرافي

  • center (مطلوبة في حال عدم توفُّر محدّدات المواقع) تحدِّد مركز الخريطة على مسافة أي أطراف الخريطة. تأخذ هذه المعلّمة موقعًا إما كزوج {latitude,longitude} مفصول بفواصل (مثل "40.714728,-73.998672") أو عنوان سلسلة (مثل "مبنى بلدية، القاهرة"، القاهرة) يحدّد موقعًا فريدًا على وجه الأرض. ولمزيد من المعلومات، يمكنك الاطّلاع على المواقع الجغرافية.
  • تحدد zoom (مطلوبة في حالة عدم وجود محدّدات) مستوى التكبير/التصغير للخريطة، وهو ما يحدد مستوى تكبير الخريطة. تأخذ هذه المعلّمة قيمة رقمية متوافقة مع مستوى التكبير/التصغير للمنطقة المطلوبة. لمزيد من المعلومات، راجع مستويات التكبير أو التصغير.

معلمات الخريطة

  • size (مطلوبة) تحدد الأبعاد المستطيلة لصورة الخريطة. تأخذ هذه المعلّمة سلسلة من النموذج {horizontal_value}x{vertical_value}. على سبيل المثال، تحدّد السمة 500x400 خريطة بعرض 500 × 400 بكسل. وستعرض الخرائط التي يقل عرضها عن 180 بكسل شعار Google بحجم مخفض. تتأثر هذه المعلّمة بالمعلّمة scale، وحجم الناتج النهائي هو ناتج قيم الحجم والمقاس.
  • تؤثر قيمة scale (اختيارية) في عدد وحدات البكسل التي يتم عرضها. تعرض scale=2 ضعف عدد وحدات البكسل التي يبلغ عرضها scale=1 مع الاحتفاظ بمنطقة التغطية نفسها ومستوى التفاصيل نفسه (أي لا يتغيّر محتوى الخريطة). ويفيد هذا عند إنشاء شاشات عالية الدقة. القيمة التلقائية هي 1. القيمتان المسموح بإدراجهما هما 1 و2. راجِع قيم الحجم للحصول على مزيد من المعلومات.
  • تحدّد السمة format (اختيارية) تنسيق الصورة الناتجة. تنشئ واجهة برمجة تطبيقات الخرائط الثابتة صور PNG تلقائيًا. هناك عدة أشكال محتملة تشمل ملفات GIF وJPEG وPNG. يعتمد التنسيق الذي تستخدمه على الطريقة التي تنوي بها عرض الصورة. يوفّر تنسيق JPEG ضغطًا أكبر عادةً، بينما يوفّر تنسيق GIF وPNG تفاصيل أكثر. ولمزيد من المعلومات، يمكنك الاطّلاع على تنسيقات الصور.
  • maptype (اختيارية) تحدد نوع الخريطة التي سيتم إنشاؤها. هناك عدة قيم محتملة لنوع الخريطة، بما في ذلك roadmap وsatellite وhybrid وterrain. لمزيد من المعلومات، راجع أنواع خرائط واجهة برمجة التطبيقات الثابتة للخرائط.
  • language (اختيارية) تحدد اللغة المطلوب استخدامها لعرض التصنيفات على مربعات الخرائط. ويُرجى العِلم أنّ هذه المعلَمة متاحة فقط لبعض فئات البلدان، وإذا كانت اللغة المحدّدة المطلوبة غير متاحة لمجموعة المربّعات، سيتم استخدام اللغة التلقائية لهذه المجموعة.
  • تحدّد السمة region (اختيارية) الحدود المناسبة لعرضها، استنادًا إلى الحساسيات الجغرافية السياسية. تقبل رمز المنطقة المحدد بقيمة ccTLD ("نطاق المستوى الأعلى") المكوّنة من حرفين. اطّلِع على تفاصيل التغطية في "منصة خرائط Google" للمناطق المتوافقة.

معلمات الميزة

  • map_id (اختيارية) تحدد المعرف لخريطة محددة. يربط معرّف الخريطة خريطة بنمط أو ميزة معينة، ويجب أن تنتمي إلى نفس المشروع كمفتاح API المستخدم لإعداد الخريطة. لمزيد من المعلومات، راجع استخدام معرّفات الخرائط.
  • تحدّد علامة markers (اختيارية) علامة أو أكثر لإرفاقها بالصورة في مواقع جغرافية محدّدة. تستخدِم هذه المعلّمة تعريف علامة واحدة مع معلَمات مفصولة بحرف الأنبوب (|). ويمكن وضع علامات متعددة داخل المعلَمة markers نفسها طالما أنها تعرض النمط نفسه. ويمكنك إضافة علامات إضافية للأنماط المختلفة من خلال إدراج معلَمات markers إضافية. يُرجى العِلم أنّه إذا قدّمت محدّدات المواقع للخريطة، لن تحتاج إلى تحديد المعلَمتَين center وzoom (المطلوبة عادةً). ولمزيد من المعلومات، اطّلِع على محدّدات API الثابتة للخرائط.
  • تحدّد السمة path (اختيارية) مسارًا واحدًا من نقطتَي اتصال أو أكثر يتم تركيبهما على الصورة في مواقع جغرافية محدّدة. تستخدِم هذه المعلّمة سلسلة من تعريفات النقاط مفصولة بحرف الأنبوب (|)، أو خط متعدد مرمّز باستخدام البادئة enc: باستخدام إعلان الموقع الجغرافي للمسار. ويمكنك توفير مسارات إضافية من خلال إضافة معلّمات path إضافية. ملاحظة: في حال توفير مسار لخريطة، لن تحتاج إلى تحديد معلمتَي center وzoom (مطلوبة عادةً). ولمزيد من المعلومات، اطّلِع على مسارات "API للخرائط الثابتة".
  • visible (اختياري) تحدد واحدًا أو أكثر من المواقع الجغرافية التي يجب أن تظل مرئية على الخريطة، على الرغم من عدم عرض أي محددات أو مؤشرات أخرى. استخدِم هذه المعلَمة لضمان عرض ميزات أو مواقع جغرافية محدّدة على الخريطة في API للخرائط الثابتة.
  • style (اختيارية) تحدد نمطًا مخصصًا لتغيير طريقة عرض عنصر محدد (الطرق والمتنزهات والميزات الأخرى) للخريطة. تتطلّب هذه المعلّمة وسيطتَي feature وelement تحدّد الميزات المطلوب تطبيق نمط عليها ومجموعة من عمليات النمط لتطبيقها على الميزات المحدّدة. يمكنك توفير أنماط متعددة من خلال إضافة معلمات style إضافية. ولمزيد من المعلومات، يمكنك الاطّلاع على دليل الخرائط ذات الأنماط.

معلمات المفتاح والتوقيع

  • تسمح لك أداة key (مطلوبة) بمراقبة استخدام واجهة برمجة التطبيقات في Google Cloud Console، وتضمن إمكانية تواصل Google معك بشأن طلبك إذا لزم الأمر. لمزيد من المعلومات، راجع استخدام مفاتيح واجهة برمجة التطبيقات مع API للخرائط الثابتة.
  • signature (مقترَح) هو توقيع رقمي يُستخدَم للتحقّق من أنّ أي موقع إلكتروني ينشئ طلبات باستخدام مفتاح واجهة برمجة التطبيقات مفوّض لتنفيذ ذلك. قد تفشل الطلبات التي لا تحتوي على توقيع رقمي. لمزيد من المعلومات، يُرجى الاطِّلاع على استخدام توقيع رقمي.

تقييد حجم عنوان URL

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

استخدام المعلمة

تتميز واجهة برمجة التطبيقات للخرائط الثابتة بالسهولة نسبيًا في الاستخدام، نظرًا لأنها لا تحتوي إلا على عنوان URL ذي معلمات. يوضح هذا القسم كيفية استخدام هذه المعلمات لإنشاء عناوين URL.

تحديد المواقع

يجب أن تتمكن واجهة برمجة تطبيقات الخرائط الثابتة من تحديد المواقع على الخريطة بدقة، وذلك لتركيز الخريطة على الموقع الصحيح (باستخدام المعلمة center) و/أو وضع أي علامات موضعية اختيارية (باستخدام المعلمة markers) على المواقع على الخريطة. تستخدم واجهة برمجة تطبيقات الخرائط الثابتة الأرقام (قيم خطوط الطول والعرض) أو السلاسل (العناوين) لتحديد هذه المواقع. تحدد هذه القيم موقعًا مميزًا جغرافيًا.

هناك عدة معلمات (مثل المعلمتين markers وpath) تأخذ مواقع متعددة. في هذه الحالات، يتم فصل المواقع الجغرافية بواسطة رمز الأنبوب (|).

خطوط العرض والطول

يتم تحديد خطوط الطول ودوائر العرض باستخدام الأرقام داخل سلسلة نصية مفصولة بفواصل تتميز بدقة تصل إلى 6 أرقام عشرية. على سبيل المثال، "40.714728,-73.998672" هي قيمة ترميز جغرافي صالحة. يتم تجاهل الدقة التي تتجاوز المنازل الستة.

تعتمد قيم خط الطول على بُعد المسافة من غرينتش، إنجلترا، حيث يقع خط الطول الرئيسي. نظرًا لأن غرينتش تقع في خط العرض 51.477222، يمكننا إدخال قيمة center بقيمة 51.477222,0 لتوسيط الخريطة على غرينتش:

غرينتش، إنجلترا

يجب أن تتوافق قيم خطوط الطول والعرض مع موقع صالح على سطح الأرض. يمكن لخطوط العرض أن تأخذ أي قيمة بين -90 و90، بينما يمكن أن تأخذ قيم خطوط الطول أي قيمة بين -180 و180. إذا حددت قيمة غير صالحة لخط العرض أو خط الطول، فسيتم رفض طلبك باعتباره طلبًا غير صالح.

العناوين

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

في أي معلمة حيث يمكنك تقديم خط العرض/الطول، يمكنك بدلاً من ذلك تحديد سلسلة تشير إلى عنوان. ستجري Google ترميزًا جغرافيًا للعنوان وتقدم لخدمة واجهة برمجة التطبيقات الثابتة للخرائط قيمة لخط العرض/الطول لاستخدامها في وضع العلامات أو تحديد المواقع. يجب أن تكون السلسلة مشفّرة بعنوان URL، على سبيل المثال، يجب تحويل العناوين مثل "دار البلدية، القاهرة، دبي" إلى "مدينة، قاعة، مدينة+مصر، دبي".

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

ينشئ المثال التالي صورة خريطة ثابتة لبيركلي، كاليفورنيا:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

بيركلي، كاليفورنيا

مستويات التكبير أو التصغير

تحتوي الخرائط في خرائط Google على عدد صحيح "لمستوى التكبير/التصغير" والذي يحدد درجة دقة العرض الحالي. مستويات التكبير/التصغير بين 0 (أدنى مستوى للتكبير، حيث يمكن مشاهدة العالم بأسره على خريطة واحدة) و 21+ (أسفل الشوارع والمباني الفردية) ممكنة ضمن عرض roadmap الافتراضي. تظهر مخططات المباني، إذا كانت متاحة، على الخريطة حول مستوى التكبير/التصغير 17. وتختلف هذه القيمة من منطقة إلى أخرى، ويمكن أن تتغير بمرور الوقت مع تطوّر البيانات.

تعيّن خرائط Google مستوى التكبير/التصغير 0 ليتضمن الأرض بالكامل. يؤدي كل مستوى تكبير/تصغير تالٍ إلى مضاعفة الدقة في الأبعاد الأفقية والرأسية. يتوفر المزيد من المعلومات حول كيفية تنفيذ هذا الإجراء في مستندات واجهة برمجة التطبيقات لجافا سكريبت في "خرائط Google".

ملاحظة: لا تظهر جميع مستويات التكبير/التصغير في جميع المواقع على الأرض. وتختلف مستويات التكبير أو التصغير بناءً على الموقع، حيث تكون البيانات في بعض أنحاء العالم أكثر دقة من المواقع الجغرافية الأخرى.

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

تعرض القائمة التالية مستوى التفاصيل التقريبي الذي يمكن أن تتوقعه عند كل مستوى من مستويات التكبير:

  • 1: العالم
  • 5: مساحة اليابسة/القارة
  • 10: مدينة
  • 15: الشوارع
  • 20: المباني

يطلب هذا المثال خريطتين لمانهاتن بالقيمة نفسها center ولكن بمستويات التكبير أو التصغير 12 و14، على التوالي:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

مانهاتن فارواي  لقطة مقرّبة لمانهاتن

أحجام الصور

تحدد المعلمة size، بالإضافة إلى center، منطقة التغطية في الخريطة. وتحدّد أيضًا حجم نتائج الخريطة بالبكسل عند ضربها بالقيمة scale (وهي 1 تلقائيًا).

يعرض هذا الجدول القيم القصوى المسموح بها للمعلمة size في كل قيمة scale.

scale=1 scale=2
640x640 640x640 (تعرض الصفحة 1280×1280 بكسل)

يتطلب هذا المثال "شريحة" من الأرض عند خط الاستواء في المستوى 1 من التكبير/التصغير:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

خط الاستواء

يتطلب هذا المثال خريطة صغيرة بحجم 100 × 100 بكسل تتوسط المنطقة نفسها. لاحظ شعار Google الأصغر حجمًا:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

خريطة خط الاستواء الصغيرة

قيم التدرج

تحدد المعلمة size في API للخرائط الثابتة حجم الخريطة بالبكسل، حتى يتم عرض الخريطة التي تشتمل على size=200x200 على أنها 200 بكسل في 200 بكسل. على شاشة الكمبيوتر بشاشة LCD، والتي عادةً ما تعرض 100 بكسل لكل بوصة تقريبًا، ستكون الخريطة بحجم 200x200 حوالي بوصتين في كل بُعد.

ومع ذلك، تشتمل أجهزة الجوّال بشكل متزايد على شاشات عالية الدقة بكثافة بكسل تزيد عن 300 بكسل لكل بوصة، والتي:

  • تقليل حجم صورة بحجم 200x200 بكسل إلى 0.7 بوصة فقط، مع عرض تصنيفات ورموز صغيرة جدًا بحيث لا يمكن قراءتها
  • يمكنك تغيير حجم (تكبير/تصغير) الصورة لتحسين وضوحها، ما يؤدي إلى عدم وضوح الصورة أو تقطيعها.
صغيرة جدًا غير واضح

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

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

150x150 150×150&تدرج=2

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

يعرض هذا الجدول ثلاثة طلبات مختلفة للصور.

  • وتكون الصورة الأولى للصورة بمقاس 100×100، بدون تحديد قيمة للمقياس. يتم عرض المحتوى بشكل صحيح على جهاز كمبيوتر سطح المكتب، ولكنه صغير جدًا بحيث لا يمكن قراءته على جهاز جوّال.
  • والثانية مضاعفة حجم الخريطة. على سطح المكتب، تتلاءم خدمة CSS مع العنصر img 100x100 المحدّد، ولكن في تقليل حجم الصورة، تصبح الطرق والتصنيفات صغيرة جدًا. على الجهاز الجوّال، حجم الصورة مناسب، ولكن الطرق والتصنيفات غير مقروءة مرة أخرى.
  • الطلب الثالث هو لخريطة بحجم 100 x 100 مع scale=2. ويتم عرض الصورة بدقة 200 بكسل، ويتم تصغير حجمها على سطح المكتب بحيث لا يمكن تمييزها عن طلب 100 x 100 الأصلي، في حين يستفيد متصفّح الجوّال من الدقة الإضافية التي تعرضها واجهة برمجة التطبيقات.
طلبات الصور
الجهاز 100x100 200x200 100x100&scale=2
كمبيوتر مكتبي
(مع height="100px" و
width="100px" على علامة
img)
دقة عالية
(محاكاة)

لمزيد من المعلومات عن تطوير التطبيقات المتوافقة مع الأجهزة الجوّالة والشاشات عالية الدقة، ننصحك بقراءة المحتوى التالي:

الأشكال المصوّرة

ويمكن عرض الصور بعدة تنسيقات شائعة لرسومات الويب: GIF وJPEG وPNG. تأخذ المعلمة format إحدى القيم التالية:

  • تحدّد السمة png8 أو png (التنسيق التلقائي) تنسيق PNG 8 بت.
  • تحدّد png32 تنسيق PNG 32 بت.
  • تحدّد gif تنسيق GIF.
  • تحدّد jpg تنسيق ضغط JPEG.
  • تحدّد السمة jpg-baseline تنسيق ضغط غير متدرج JPEG.

تطلب هذه الأمثلة الخرائط بتنسيقين gif وpng:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

يوفر كل من jpg وjpg-baseline عادةً أصغر حجم للصورة، إلا أنهما ينفذان من خلال ضغط "مفقود"، ما قد يؤدي إلى انخفاض جودة الصورة. gif وpng8 وpng32 ضغطًا بدون فقدان البيانات.

تكون معظم صور JPEG تدريجية، أي أنّها تحمّل صورة تقريبيّة في وقت سابق وحسّنت درجة دقة الصورة مع توفّر بيانات أكثر. ويتيح هذا إمكانية تحميل الصور بسرعة في صفحات الويب، وهو الاستخدام الأكثر انتشارًا لملفات JPEG حاليًا. ومع ذلك، تتطلب بعض استخدامات JPEG صورًا غير خطية (أساسية). في مثل هذه الحالات، من الأفضل استخدام التنسيق jpg-baseline، وهو عرض غير متدرّج.

أنواع الخريطة

تنشئ واجهة برمجة تطبيقات الخرائط الثابتة خرائط بتنسيقات متعددة، مدرجة أدناه:

  • تحدّد السمة roadmap (تلقائية) صورة عادية لخريطة الطريق، كما تظهر عادةً على الموقع الإلكتروني لخدمة "خرائط Google". في حال عدم تحديد قيمة maptype، تعرض "واجهة برمجة التطبيقات الثابتة للخرائط" مربّعات roadmap بشكل تلقائي.
  • يحدد satellite صورة القمر الصناعي.
  • تحدّد السمة terrain صورة لخريطة الإغاثة المادية تعرض التضاريس والنباتات.
  • تحدد hybrid مزيجًا من صورة القمر الصناعي وخريطة الطريق، مع عرض طبقة شفافة من الشوارع الرئيسية وأسماء الأماكن في صورة القمر الصناعي.

يمكنك مشاهدة الفرق بين أنواع خارطة الطريق وأنواع التضاريس في مثال الشفرة هذا.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

خريطة مانهاتن العادية  خريطة تضاريس مانهاتن

تستخدم الخرائط المختلطة صور القمر الصناعي وميزات خارطة الطريق البارزة لإنشاء خريطة مجمّعة. توضح الأمثلة التالية أنواع الأقمار الصناعية والخريطة المختلطة:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

خريطة القمر الصناعي في مانهاتن  خريطة تضاريس مانهاتن

خرائط ذات أنماط

خصص العرض التقديمي لخريطة Google القياسية عن طريق تطبيق أنماطك الخاصة. الاطلاع على دليل الخرائط ذات الأنماط.

Markers

تحدد المعلمة markers مجموعة من واحد أو أكثر من محددات المواقع (دبابيس الخريطة) في مجموعة من المواقع. يجب أن يعرض كل محدّد موقع محدد في بيان markers واحد النمط المرئي نفسه، وإذا كنت ترغب في عرض محدّدات المواقع بأنماط مختلفة، يجب تقديم معلمات markers متعددة مع معلومات نمط منفصلة.

تأخذ المعلمة markers مجموعة من تعيينات القيم (واصفات العلامات) للتنسيق التالي:

markers=markerStyles|markerLocation1| markerLocation2|... إلخ.

يتم الإعلان عن مجموعة markerStyles في بداية إعلان markers وتتألف من وصف للأنماط صفر أو أكثر مفصولة بحرف الأنبوب (|)، متبوعًا بمجموعة من موقع واحد أو أكثر مفصولة أيضًا بحرف الأنبوب (|).

نظرًا لأنه يتم الفصل بين معلومات النمط ومعلومات الموقع عبر حرف الأنبوب، يجب أن تظهر معلومات النمط أولاً في أي وصف واصف. عندما يصادف خادم API الثابت للخرائط موقعًا في واصف العلامة، من المفترض أن تكون جميع معلمات العلامات الأخرى مواقع أيضًا.

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

مجموعة أدوات وصف نمط العلامة هي سلسلة من تعيينات القيم مفصولة بفواصل (|). ويصف واصف النمط هذا السمات المرئية المطلوب استخدامها عند عرض المحددات داخل وصف العلامة هذا. تحتوي كلمات وصف النمط هذه على تعيينات المفتاح/القيمة التالية:

  • تحدّد size: (اختيارية) حجم العلامة من المجموعة {tiny, mid, small}. إذا لم يتم ضبط معلمة size ، ستظهر العلامة بحجمها التلقائي (العادي).
  • تحدّد السمة color: (اختيارية) لونًا بحجم 24 بت (مثال: color=0xFFFFCC) أو لونًا محدّدًا مسبقًا من المجموعة {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

    يُرجى العلم بأن العلامات الشفافة (المحدّدة باستخدام قيم ألوان سداسية عشرية 32 بت) غير متوافقة مع المحدِّدات، على الرغم من أنها متوافقة مع المسارات.

  • label: (اختياري) يحدد حرفًا واحدًا كبرٍ أبجدي رقمي في المجموعة {A-Z, 0-9}. (لا ينطبق متطلّب الأحرف الكبيرة إلا على هذا الإصدار من واجهة برمجة التطبيقات). يُرجى العِلم بأنّ العلامات التلقائية وحجم mid هي العلامات الوحيدة القادرة على عرض معلَمة alphanumeric-character. ولا يمكن للعلامتين tiny وsmall عرض الأحرف الأبجدية الرقمية.

تغيير حجم العلامة

يتم ضرب قيمة scale في حجم صورة العلامة لإنتاج حجم الإخراج الفعلي للعلامة بالبكسل. القيمة التلقائية للتدرّج هي 1؛ والقيم المقبولة هي 1 و2 و4.

ينطبق حد حجم البكسل على الصور بعد تطبيق التحجيم. على سبيل المثال، إذا تم ضبط العلامة على scale:2، يمكن أن تكون العلامة أكبر من الحد الأقصى للحجم وهو 4096 بكسل، طالما تقل إلى أقل من 4096 بكسل بعد تغيير الحجم. استخدم تحجيم العلامة بالتزامن مع تغيير حجم الخريطة عند عرض خرائط عالية الدقة.

مواقع العلامة

يجب أن يحتوي كل وصف للعلامة على مجموعة من واحد أو أكثر من المواقع التي تحدد مكان وضع العلامة على الخريطة. قد يتم تحديد هذه المواقع إما كقيم خطوط طول/خط عرض أو كـ عناوين. ويتم فصل هذه المواقع باستخدام رمز الأنبوب (|).

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

تحدد معلمات الموقع موقع العلامة على الخريطة. إذا كان الموقع خارج الخريطة، فلن تظهر هذه العلامة في الصورة التي تم إنشاؤها، بشرط أن يتم توفير معلمات center وzoom. ومع ذلك، إذا لم يتم تقديم هذه المعلمات، سينشئ خادم API الثابت للخرائط تلقائيًا صورة تحتوي على العلامات المحدّدة. (راجع تحديد الموضع الضمني.)

يتم عرض نموذج لإعلان العلامة هنا. لاحظ أننا نحدد مجموعة واحدة من الأنماط وثلاثة مواقع:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

ثلاثة رموز بريدية في بروكلين

لتحديد محددات ذات أنماط مختلفة، يجب تقديم معلمات markers متعددة. تعرّف هذه المجموعة من معلمات markers ثلاث علامات: علامة زرقاء واحدة على الشكل التالي "S" في 62.107733، -145.5419، وعلامة خضراء صغيرة في "دلتا جانكشن، AK" وعلامة صفراء متوسطة واحدة تحمل الاسم "C" في "Tok, AK". يتم عرض هذه المحددات في هذا المثال:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

ثلاث مدن بألاسكا، علامات مختلفة

الرموز المخصصة

بدلاً من استخدام رموز علامات Google، يمكنك استخدام الرموز المخصصة التابعة لك بدلاً من ذلك. يتم تحديد الرموز المخصّصة باستخدام الواصف icon في المعلَمة markers. مثلاً:

markers=icon:URLofIcon|markerLocation

حدِّد السمة icon باستخدام عنوان URL (يجب ترميزه باستخدام عنوان URL). يمكنك استخدام عناوين URL التي تم إنشاؤها بواسطة خدمات تقصير عناوين URL مثل https://goo.gl. تتمتع معظم خدمات تقصير عناوين URL بميزة تشفير عناوين URL تلقائيًا.

يمكنك تحديد نقطة ارتساء للرمز المخصص. تحدد نقطة الارتساء كيفية وضع الرمز بالنسبة إلى مواقع markers المحددة. بشكل افتراضي، تكون نقطة الارتساء لرمز مخصص هي الجزء الأوسط السفلي من صورة الرمز. يمكنك تحديد نقطة ارتساء مختلفة باستخدام واصف anchor بالاقتران مع icon. يمكنك ضبط anchor كنقطة x أو y في الرمز (مثل 10,5) أو كمحاذاة مسبقًا باستخدام إحدى القيم التالية: top أو bottom أو left أو right أو center أو topleft أو topright أو bottomleft أو bottomright. مثلاً:

markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2

يمكنك استخدام ما يصل إلى خمسة رموز مخصصة فريدة لكل طلب. ولا يعني هذا القيد أنك تقتصر على 5 مواقع محددة فقط على خريطتك. يمكن استخدام كل رمز فريد مع أكثر من موقع markers واحد على خريطتك.

تنسيق الرمز:

  • وقد تكون صور الرموز بتنسيق PNG أو JPEG أو GIF، إلا أننا ننصح باستخدام تنسيق PNG.
  • يمكن أن يصل حجم الرموز إلى 4096 بكسل كحد أقصى (64×64 للصور المربّعة).
أمثلة على الرموز المخصّصة

المثال 1 ينشئ رموزًا مخصصة ويحدد مواضع الرموز باستخدام نقاط الارتساء.

http://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

ثلاث مدن أسترالية برموز مخصّصة ومختلفة يتم وضعها على نقاط الارتساء.

المثال 2 ينشئ الرموز المخصصة نفسها مثل المثال 1، ولكنه لا يعيّن مواضع الرموز باستخدام نقاط الارتساء، بناءً على الارتساء الافتراضي في الوسط السفلي.

http://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

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

مسارات API الثابتة للخرائط

تحدد المعلمة path مجموعة من موقع واحد أو أكثر مرتبطة بمسار تركيب على صورة الخريطة. تأخذ المعلمة path مجموعة من تعيينات القيم (واصفات المسار) للتنسيق التالي:

path=pathStyles|pathLocation1|pathLocation2|... إلخ.

لاحظ أن نقطتي المسار منفصلتان عن بعضهما البعض باستخدام رمز الأنبوب (|). ونظرًا لأن معلومات النمط ومعلومات النقاط محددة بفواصل بواسطة رمز الأنبوب، يجب أن تظهر معلومات النمط أولاً في أي وصف للمسار. عندما يصادف خادم API الثابت للخرائط موقعًا في واصف المسار، تفترض جميع معلمات المسار الأخرى أنها مواقع أيضًا.

أنماط المسار

مجموعة أدوات وصف نمط المسار هي سلسلة من تعيينات القيم مفصولة بفواصل (|). ويصف واصف النمط هذا السمات المرئية المطلوب استخدامها عند عرض المسار. تتضمن وصفات النمط هذه تعيينات المفتاح/القيمة التالية:

  • تحدّد السمة weight: (اختيارية) سُمك المسار بالبكسل. في حال عدم ضبط معلمة weight، سيظهر المسار بسُمك تلقائي (5 بكسل).
  • تحدّد السمة color: (اختيارية) لونًا بقيمة 24 بت (مثال: color=0xFFFFCC) أو قيمة سداسية عشرية 32 بت (مثال: color=0xFFFFCCFF) أو من المجموعة {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

    عند تحديد قيمة ست عشرية 32 بت، يحدد الحرفان الأخيران قيمة شفافية ألفا 8 بت. وتتراوح هذه القيمة بين 00 (شفافة بالكامل) وFF (مبهمة تمامًا). يُرجى العِلم أنّ عمليات الشفافية متوفّرة في المسارات، ولكنها غير متوافقة مع المحدِّدات.

  • تشير القيمة fillcolor: (اختيارية) إلى أنّ المسار يُحدّد منطقة مضلعة ويحدّد لون التعبئة المراد استخدامه كتراكب على هذه المنطقة. لا يلزم أن تكون مجموعة المواقع التالية حلقة "مغلقة"، لأن خادم واجهة برمجة التطبيقات الثابتة للخرائط سينضم تلقائيًا إلى النقطتين الأولى والأخيرة. يُرجى العِلم بأنّه لن يتم إغلاق أي شطب على الجزء الخارجي من المنطقة الممتلئة ما لم تقدّم موقعَي البدء والانتهاء نفسَيهما.
  • تشير القيمة geodesic: (اختياري) إلى أن المسار المطلوب يجب تفسيره كخط جيوديسي يتبع انحناء الأرض. وعند اختيار القيمة "false"، يتم عرض المسار كخط مستقيم في مساحة الشاشة. إعداد القيمة التلقائية على "false".

في ما يلي بعض تعريفات المسار:

  • خط أزرق رقيق، تعتيم بنسبة 50%: path=color:0x0000ff80|weight:1
  • خط أحمر خالص: path=color:0xff0000ff|weight:5
  • خط أبيض سميك صلب: path=color:0xffffffff|weight:10

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

نقاط المسار

لرسم مسار، يجب أيضًا تمرير المعلمة path نقطتين أو أكثر. وبعد ذلك، ستربط واجهة برمجة التطبيقات للخرائط الثابتة المسار على هذه النقاط، بالترتيب المحدد. تتم الإشارة إلى كل pathPoint في pathDescriptor مفصولًا بحرف | (أنبوب).

يوضح المثال التالي مسارًا أزرق بدرجة تعتيم تلقائية تبلغ 50% من موقع شركة Union Square NY إلى Times Square, NY.

المسار من &quot;ميدان الاتحاد&quot; إلى &quot;ميدان التايمز&quot;

تفاصيل المعلَمة path هي:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

يوضح المثال التالي المسار نفسه بدلاً من ذلك الذي يحدد خطًا أحمر ثابتًا بدرجة تعتيم 100%:

المسار من &quot;ميدان الاتحاد&quot; إلى &quot;ميدان التايمز&quot;

تفاصيل معلمة path هذه هي:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

يحدد المثال التالي منطقة مضلعة داخل مانهاتن، وقد تم تمرير سلسلة من التقاطعات كمواقع:

المسار من &quot;ميدان الاتحاد&quot; إلى &quot;ميدان التايمز&quot;

تفاصيل معلمة path هذه هي:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

لاحظ أننا نعيّن المسار نفسه ليكون غير مرئي والمنطقة المضلعة التي يكون فيها التعتيم 15%.

الخطوط المتعددة المشفّرة

بدلاً من استخدام سلسلة من المواقع الجغرافية، يمكنك تحديد مسار كـ مخطّط متعدد مرمّز باستخدام البادئة enc: في بيان الموقع الجغرافي path.

يوضح المثال التالي مسار الطريق السريع لألاسكا من داوسون كريك، كولومبيا البريطانية إلى دلتا جانكشن، ألاسكا مع خط متعدد مشفر:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

طريق ألاسكا السريع

كما هو الحال في المسارات القياسية، قد تحدد أيضًا المسارات متعددة الخطوط المشفّرة المناطق المضلّعة في حالة تمرير الوسيطة fillcolor إلى المعلمة path.

يوضح المثال التالي منطقة مضلعة لمدينة بروكلين، نيويورك:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

بروكلين اند بوليد مع توقيع

إطارات العرض

قد تحدد الصور إطار عرض من خلال تحديد المواقع المرئية باستخدام المعلمة visible. توجِّه المَعلمة visible خدمة واجهة برمجة التطبيقات الثابتة في "خرائط Google" لإنشاء خريطة بحيث تظل المواقع الجغرافية الحالية مرئية. (قد يتم دمج هذه المعلمة مع علامات أو مسارات حالية لتحديد منطقة مرئية أيضًا). ويحدّد تحديد إطار العرض بهذه الطريقة الحاجة إلى تحديد مستوى تكبير دقيق.

المثال التالي يطلب خريطة تتمركز حول بوسطن، ماساتشوستس تحتوي على كل من معهد ماساتشوستس للتكنولوجيا وميدان هارفارد في كامبريدج، ماساتشوستس:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

خريطة كامبريدج

تحديد موضع ضمني للخريطة

عادة، تحتاج إلى تحديد معلمات center وzoom لعنوان URL لتحديد الموقع ومستوى التكبير/التصغير للخريطة التي تم إنشاؤها. ومع ذلك، في حال تقديم معلَمات markers أو path أو visible، يمكنك بدلاً من ذلك السماح لواجهة برمجة تطبيقات "خرائط Google" الثابتة بتحديد المركز الصحيح ومستوى التكبير/التصغير بشكلٍ ضمني، استنادًا إلى تقييم موضع هذه العناصر.

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

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

خريطة طريق

أحجام صور أكبر

إذا كنت تريد صورًا بأحجام أكبر من 640 × 640 بكسل (أو 1280 × 1280 بكسل بحجم 2)، فالرجاء الاتصال بفريق الدعم وتقديم المعلومات التالية:

  1. حالة استخدامك وسبب احتياجك إلى صور كبيرة الحجم
  2. يمكنك استخدام واجهات برمجة تطبيقات أخرى في "منصة خرائط Google" (واجهة برمجة تطبيقات JavaScript للخرائط أو واجهة برمجة التطبيقات لتضمين الخرائط أو حزمة تطوير برامج "خرائط Google" لأجهزة Android أو حزمة تطوير برامج "خرائط Google" لنظام التشغيل iOS) وتوضيح سبب عدم تلبية هذه المتطلبات.
  3. لقطات شاشة أو نماذج أو نماذج عن كيفية استخدام الصور كبيرة الحجم.
  4. الاستخدام الشهري المقدّر للصور كبيرة الحجم

ستتم مراجعة طلبك بناءً على المعلومات التي تقدمها وتحديد ما إذا كانت حالة استخدامك تتوافق مع بنود خدمة Google Maps Platform أم لا.

الحد الأقصى للحجم الذي يمكننا تقديمه هو 2048 × 2048 بكسل.

تحرّي الخلل وإصلاحه والدعم

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

قد تصدر واجهة برمجة تطبيقات الخرائط الثابتة خطأ أو تحذيرًا عندما يحدث خطأ ما. ويجب أن تتحقق من التحذيرات تحديدًا إذا لاحظت أن هناك شيئًا ما غير موجود في الخريطة. من المفيد أيضًا البحث عن التحذيرات قبل إطلاق تطبيق جديد. يُرجى العِلم بأن التحذيرات قد لا تظهر على الفور لأنها تظهر في عنوان HTTP. ولمزيد من المعلومات، يمكنك الاطّلاع على دليل الأخطاء والتحذيرات.