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

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

الخطوات الأولى

مقدمة

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

ملاحظة مهمة: تستخدم مناقشة معلَمات عناوين URL أمثلة يتم توضيحها في نموذج ما قبل إنهاء عناوين URL. قبل إرسال أي طلب إلى واجهة برمجة التطبيقات، يجب ترميز معلماته بشكل صحيح باستخدام عنوان URL بترميز URL. على سبيل المثال، تستخدم العديد من المعلَمات حرف الشرطة الرأسية (|) كفاصل، والذي يجب ترميزه بالرمز %7C في عنوان URL النهائي، كما في المثال السريع الظاهر أعلى هذا المستند. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء عنوان URL صالح.

تحدّد واجهة Maps Static API صور الخريطة باستخدام مَعلَمات عناوين URL التالية:

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

center (مطلوبة في حال عدم توفّر العلامات) تحدّد مركز الخريطة على بُعد مسافة متساوية من جميع حواف الخريطة. وتتخذ هذه المَعلمة الموقع الجغرافي إما كزوج { أطلس/خط الطول والعرض} المفصول بفواصل (على سبيل المثال، "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 (اختيارية) تحدّد معرّف خريطة معيّنة. يربط معرّف الخريطة الخريطة بنمط أو ميزة معيّنة، ويجب أن ينتمي إلى المشروع نفسه الذي ينتمي إليه مفتاح واجهة برمجة التطبيقات المستخدَم لإعداد الخريطة. لمزيد من المعلومات، راجع استخدام معرّفات الخرائط.
markers (اختياري) حدِّد علامة واحدة أو أكثر لإرفاقها بالصورة في المواقع الجغرافية المحدّدة. تأخذ هذه المعلَمة تعريف علامة واحدًا بمَعلمات يفصل بينها رمز علامة الشرطة الرأسية (|). ويمكن وضع علامات متعدّدة ضمن المَعلمة markers نفسها ما دامت تعرض النمط نفسه. يمكنك إضافة المزيد من العلامات بأنماط مختلفة عن طريق إضافة معلَمات markers إضافية. يُرجى العِلم أنّه في حال توفير علامات لخريطة، لن تحتاج إلى تحديد المعلّمتَين center وzoom (المطلوبتَين عادةً). لمزيد من المعلومات، اطّلِع على العلامات الثابتة لواجهة برمجة التطبيقات في "خرائط Google".
path (اختيارية) تحدّد مسارًا واحدًا لنقطتين مرتبطتين أو أكثر للتراكب على الصورة في مواقع جغرافية محدّدة. تستخدم هذه المعلَمة سلسلة من تعريفات النقاط يفصل بينها رمز الشرطة الرأسية (|)، أو خطًا متعددًا مرمّزًا باستخدام البادئة enc: ضمن بيان الموقع للمسار. يمكنك توفير مسارات إضافية عن طريق إضافة معلَمات path إضافية. يُرجى العِلم أنّك في حال توفير مسار لخريطة، لن تحتاج إلى تحديد المعلّمتَين center وzoom (المطلوبتَين عادةً). لمزيد من المعلومات، اطّلِع على مقالة مسارات واجهة برمجة التطبيقات الثابتة للخرائط.
visible (اختيارية) تحدد موقعًا جغرافيًا واحدًا أو أكثر يجب أن يظل مرئيًا على الخريطة، ولكن لن يتم عرض أي علامات أو مؤشرات أخرى. استخدِم هذه المَعلمة لضمان عرض ميزات أو مواقع معيّنة على الخريطة في Maps Static API.
تحدّد السمة style (اختيارية) نمطًا مخصّصًا لتغيير طريقة عرض عنصر معين (الطرق والمتنزهات والميزات الأخرى) في الخريطة. تستخدِم هذه المَعلمة الوسيطات feature وelement التي تحدّد الميزات التي سيتم استخدامها في النمط، بالإضافة إلى مجموعة من عمليات النمط لتطبيقها على الميزات المحدّدة. يمكنك توفير أنماط متعددة عن طريق إضافة معلَمات style إضافية. لمزيد من المعلومات، اطّلِع على دليل الخرائط ذات التصميم.

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

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

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

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

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

تتميز واجهة برمجة التطبيقات Maps Static API بسهولة الاستخدام، لأنّها تتألف فقط من عنوان URL يتضمّن معلَمات. يوضّح هذا القسم كيفية استخدام هذه المعلمات لإنشاء عناوين URL.

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

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

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

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

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

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

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

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

العناوين

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

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

لاحظ أن العناوين قد تعكس المواقع الدقيقة، مثل عناوين الشوارع، والخطوط المتعددة مثل المسارات المسماة، أو المناطق المضلعة مثل المدن أو البلدان أو المنتزهات الوطنية. بالنسبة إلى النتائج المتعددة الخطوط والمضلعة، سيستخدم خادم Maps Static 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 لتغطية الأرض بالكامل. يعمل كل مستوى تكبير متتابع على مضاعفة الدقة في كل من الأبعاد الأفقية والرأسية. يمكنك الاطّلاع على مزيد من المعلومات حول طريقة تنفيذ ذلك في مستندات واجهة برمجة تطبيقات JavaScript لـ "خرائط Google".

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

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

تعرض القائمة التالية المستوى التقريبي للتفاصيل التي يمكنك توقّع مشاهدتها في كل مستوى من مستويات التكبير/التصغير:

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 لواجهة Maps Static API حجم الخريطة بالبكسل، بحيث يتم عرض الخريطة التي تتضمّن size=200x200 بحجم 200 بكسل × 200 بكسل. على شاشة الكمبيوتر LCD التي تعرض عادةً حوالي 100 بكسل لكل بوصة (ppi)، سيكون حجم الخريطة 200x200 بوصة حوالي 2 بوصة في كل بُعد.

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

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

صغيرة جدًا	ضبابي للغاية

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

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

150 × 150	150x150&scale=2

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

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

الأول لصورة مقاس 100×100، بدون تحديد قيمة مقياس. يتم عرض النص بشكل صحيح على الكمبيوتر المكتبي، ولكنه صغير جدًا بحيث لا يمكن قراءته على الجهاز الجوّال.
والثانية مضاعفة حجم الخريطة. أمّا على جهاز الكمبيوتر المكتبي، فتحتوي لغة CSS على عنصر img المحدّد بحجم 100×100، ولكن عند تصغير حجم الصورة، تصبح الطرق والتصنيفات صغيرة جدًا. تظهر الصورة بالحجم الصحيح على الجهاز الجوّال، إلا أنّ الطرق والتسميات غير قابلة للقراءة أيضًا.
الطلب الثالث هو لخريطة 100×100 مع scale=2. يتم عرض الصورة مع تفاصيلها 200 بكسل، ويصغر حجمها الكمبيوتر المكتبي بشكل مثالي، لذا لا يمكن تمييزها عن الطلب الأصلي 100×100، بينما يستفيد المتصفّح المتوافق مع الأجهزة الجوّالة من الدقة الإضافية التي تعرضها واجهة برمجة التطبيقات.

طلبات الصور
الجهاز	`100x100`	`200x200`	`100x100&scale=2`
أجهزة الكمبيوتر المكتبي (مع `height="100px"` و `width="100px"` على علامة `img`)
دقة عالية (في وضع المحاكاة)

ملاحظة: تتيح الأنظمة الأساسية للأجهزة الجوّالة، مثل Android وiOS، للتطبيقات إمكانية التوافق مع الشاشات العالية الدقة من خلال تحديد صور منفصلة لكل درجة دقة. وتسهّل معلَمة المقياس طلب صورة خريطة لشاشة ذات دقة عادية، والخريطة المطابقة لشاشة عالية الدقة، ما عليك سوى ضبط scale=1 وscale=2 على التوالي.

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

إتاحة الشاشات المتعددة في مستندات مطوّري برامج Android
توصيات Webkit.org بشأن تطوير مواقع الويب ذات النقاط العالية لكل بوصة (DPI) على الويب.
إتاحة الشاشات العالية الدقة في "مكتبة مطوِّري تطبيقات iOS"

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

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

يحدد png8 أو png (تلقائيًا) تنسيق PNG 8 بت.
يحدّد png32 تنسيق 32 بت PNG.
تحدّد السمة 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، وهو تنسيق غير تدريجي.

أنواع الخرائط

تنشئ Maps Static API الخرائط بعدة تنسيقات، على النحو التالي:

تحدّد roadmap (تلقائية) صورة عادية لخارطة طريق، كما هو موضّح عادةً على موقع "خرائط Google" الإلكتروني. إذا لم يتم تحديد قيمة maptype، ستعرض واجهة Maps Static API مربّعات 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 وتتكوّن من قيمة صفرية أو أكثر من أوصاف الأنماط مفصولة بحرف الشرطة الرأسية (|)، متبوعة بمجموعة من موقع واحد أو أكثر تفصل بينها أيضًا رمز شرطة رأسية (|).

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

أنماط العلامات

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

size: (اختياري) يحدد حجم العلامة من مجموعة {tiny, mid, small}. إذا لم يتم ضبط معلَمة size، ستظهر العلامة بحجمها التلقائي (العادي).
color: (اختياري) يحدد لون 24 بت (مثال: color=0xFFFFCC) أو لونًا محددًا مسبقًا من المجموعة {black, brown, green, purple, yellow, blue, gray, orange, red, white}.
يُرجى العلم أنّ درجات الشفافية (المحدّدة باستخدام قيم ألوان سداسية عشرية 32 بت) غير متاحة في العلامات، على الرغم من أنّها متوافقة مع المسارات.
label: (اختيارية) تحدد حرفًا أبجديًا رقميًا واحدًا uppercase من المجموعة {A-Z, 0-9}. (متطلبات استخدام الأحرف الكبيرة جديدة في هذا الإصدار من واجهة برمجة التطبيقات). يُرجى العلم أنّ العلامات التلقائية وبحجم mid هما العلامات الوحيدة القادرة على عرض المعلَمة alphanumeric-character. ولا يمكن لعلامتَي tiny وsmall عرض أحرف أبجدية رقمية.

قياس العلامة

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

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

مواقع العلامات

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

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

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

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

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

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

تنسيق الرمز:

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

أمثلة على الرموز المخصّصة

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

https://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، ولكنه لا يضبط مواضع الرموز باستخدام علامات الارتساء، بالاعتماد على الارتساء الافتراضي في الجزء السفلي الأوسط.

https://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

مسارات واجهة برمجة التطبيقات الثابتة للخرائط

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

path=pathStyles|pathLocation1|pathLocation2|... وما إلى ذلك.

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

أنماط المسار

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

تحدد السمة 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: (اختيارية) إلى أنّ المسار يميّز منطقة مضلّعة ويحدّد لون التعبئة المطلوب استخدامه كتراكب داخل تلك المنطقة. ليس بالضرورة أن تكون مجموعة المواقع الجغرافية التالية حلقة "مغلقة"، لأنّ خادم Maps Static API سينضم تلقائيًا إلى النقطة الأولى والأخيرة. ومع ذلك، لن يتم إغلاق أي سُمك على الجزء الخارجي من المنطقة المعبأة ما لم يتم توفير موقع البداية والنهاية نفسهما على وجه التحديد.
تشير السمة geodesic: (اختيارية) إلى أنّه يجب تفسير المسار المطلوب على أنّه خط جيوديسي يتّبع انحناء الأرض. أما عند ضبط القيمة على "خطأ"، يتم عرض المسار كخط مستقيم في مساحة الشاشة. يكون الخيار التلقائي هو "خطأ".

في ما يلي بعض الأمثلة على تعريفات المسارات:

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

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

نقاط المسار

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

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

الطريق من "يونيون سكوير" إلى "تايمز سكوير"

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

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

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

الطريق من "يونيون سكوير" إلى "تايمز سكوير"

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

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

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

الطريق من "يونيون سكوير" إلى "تايمز سكوير"

في ما يلي تفاصيل حول المَعلمة 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

Prooklyn Encoded Polyline بالتوقيع

إطارات العرض

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

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

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

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

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

تحتاج عادةً إلى تحديد معلَمتي عنوان URL center وzoom لتحديد الموقع ومستوى التكبير/التصغير للخريطة التي تم إنشاؤها. مع ذلك، إذا قدّمت مَعلمات markers أو path أو visible، يمكنك بدلاً من ذلك السماح لواجهة Maps Static API بتحديد موضعَي المركز والتكبير/التصغير الصحيحَين ضمنيًا، وذلك بناءً على تقييم موضع هذه العناصر.

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

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)، يُرجى التواصل مع فريق الدعم وتقديم المعلومات التالية:

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

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

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

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

لمزيد من المعلومات عن استخدام واجهة Maps Static API، يمكنك الاطّلاع على صفحة الدعم.

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