مقدمة
تعرض Maps Static API صورة (إما GIF أو PNG أو JPEG) استجابةً لطلب HTTP عبر عنوان URL. لكل طلب، يمكنك تحديد الموقع الجغرافي للخريطة وحجم الصورة ومستوى التكبير ونوع الخريطة وموضع العلامات الاختيارية في المواقع الجغرافية على الخريطة. يمكنك أيضًا تسمية العلامات باستخدام أحرف أبجدية رقمية.
يتم تضمين صورة Maps Static API ضمن سمة src لعلامة <img> أو ما يعادلها في لغات البرمجة الأخرى.
يصف هذا المستند التنسيق المطلوب لعناوين URL في Maps Static API والمعلَمات المتاحة. ويشير أيضًا إلى بعض النصائح والحيل في تحديد عناوين URL الخاصة بك.
قبل البدء
هذا المستند مخصّص لمطوّري المواقع الإلكترونية والأجهزة الجوّالة الذين يريدون تضمين صور Maps Static API في صفحة ويب أو تطبيق على الأجهزة الجوّالة. ويقدّم مقدمة حول استخدام واجهة برمجة التطبيقات والمواد المرجعية حول المَعلمات المتاحة.
قبل بدء التطوير باستخدام Maps Static API، راجِع متطلبات المصادقة (ستحتاج إلى مفتاح واجهة برمجة التطبيقات) ومعلومات استخدام واجهة برمجة التطبيقات والفوترة (ستحتاج إلى تفعيل الفوترة في مشروعك).
معلمات عنوان URL
يجب أن يكون عنوان URL لواجهة برمجة التطبيقات Maps Static API على النحو التالي:
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، يتم الفصل بين جميع المَعلمات باستخدام علامة العطف (&). يتم تعداد قائمة المَعلمات وقيمها المحتملة في هذا المستند.
تحدّد واجهة برمجة التطبيقات Maps Static API صور الخرائط باستخدام مَعلمات عناوين URL التالية:
مَعلمات الموقع الجغرافي
center(مطلوبة في حال عدم توفّر علامات) تحدّد مركز الخريطة، على مسافة متساوية من جميع حواف الخريطة. تأخذ هذه المَعلمة موقعًا جغرافيًا إما كزوج {خط العرض، خط الطول} مفصول بفاصلة (مثل "40.714728,-73.998672") أو عنوان سلسلة (مثل "city hall, new york, ny") يحدّد موقعًا جغرافيًا فريدًا على وجه الأرض. لمزيد من المعلومات، يُرجى الاطّلاع على المواقع الجغرافية.- تحدّد السمة
zoom(مطلوبة في حال عدم توفّر علامات) مستوى التكبير للخريطة، والذي يحدّد مستوى تكبير الخريطة. تأخذ هذه المَعلمة قيمة رقمية تتوافق مع مستوى التكبير للمنطقة المطلوبة. لمزيد من المعلومات، يُرجى الاطّلاع على مستويات التكبير.
مَعلمات الخريطة
size(مطلوبة): تحدّد الأبعاد المستطيلة لصورة الخريطة. تتطلّب هذه المَعلمة سلسلة بالتنسيق{horizontal_value}x{vertical_value}. على سبيل المثال، تحدّد السمة500x400خريطة بعرض 500 بكسل وارتفاع 400 بكسل. ستعرض الخرائط التي يقل عرضها عن 180 بكسل شعار Google بحجم أصغر. تتأثر هذه المَعلمة بمَعلمةscale، ويكون حجم الناتج النهائي هو حاصل ضرب قيمتَي الحجم والمقياس.scale(اختياري) يؤثر في عدد وحدات البكسل التي يتم عرضها. تعرض القيمةscale=2ضعف عدد وحدات البكسل التي تعرضها القيمةscale=1مع الاحتفاظ بمنطقة التغطية ومستوى التفاصيل نفسهما (أي أنّ محتوى الخريطة لا يتغيّر). ويُعدّ ذلك مفيدًا عند تطوير تطبيقات لشاشات العرض العالية الدقة. تكون القيمة التلقائية1. القيم المقبولة هي1و2. يمكنك الاطّلاع على قيم المقياس لمزيد من المعلومات.format(اختياري) يحدّد تنسيق الصورة الناتجة. تنشئ Maps Static API صورًا بتنسيق PNG تلقائيًا. هناك عدة تنسيقات ممكنة، بما في ذلك أنواع GIF وJPEG وPNG. ويعتمد التنسيق الذي تستخدمه على الطريقة التي تنوي بها عرض الصورة. يوفّر تنسيق JPEG عادةً ضغطًا أكبر، بينما يوفّر تنسيقا GIF وPNG تفاصيل أكثر. لمزيد من المعلومات، يُرجى الاطّلاع على تنسيقات الصور.maptype(اختياري) يحدّد نوع الخريطة التي سيتم إنشاؤها. هناك عدة قيم محتملة لـ maptype، بما في ذلكroadmapوsatelliteوhybridوterrain. لمزيد من المعلومات، يُرجى الاطّلاع على أنواع الخرائط في Maps Static API.colorscheme(اختياري) يحدّد نظام الألوان للخريطة. القيم المقبولة هيlight(تلقائية) وdark. ينطبق نظام الألوان الداكنة على نوعَي الخريطةroadmapوterrain. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على الأوضاع وأنواع الخرائط.- تحدّد المَعلمة
language(اختيارية) اللغة التي سيتم استخدامها لعرض التصنيفات على مربّعات الخريطة. يُرجى العِلم أنّ هذه المَعلمة متاحة فقط لبعض مربّعات البلدان. إذا كانت اللغة المحدّدة المطلوبة غير متاحة لمجموعة المربّعات، سيتم استخدام اللغة التلقائية لمجموعة المربّعات هذه. region(اختياري) يحدّد الحدود المناسبة التي يجب عرضها، استنادًا إلى الحساسيات الجيوسياسية. يقبل هذا المَعلمة رمز منطقة محدّدًا كقيمة ccTLD (نطاق المستوى الأعلى) مكوّنة من حرفَين. يمكنك الاطّلاع على تفاصيل تغطية "منصة خرائط Google" لمعرفة المناطق المعتمدة.
مَعلمات الميزات
map_id(اختياري) يحدّد معرّف خريطة معيّنة. يربط رقم تعريف الخريطة خريطةً بنمط أو ميزة معيّنة، ويجب أن ينتمي إلى المشروع نفسه الذي ينتمي إليه مفتاح واجهة برمجة التطبيقات المستخدَم لإعداد الخريطة. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام معرّفات الخرائط.markers(اختيارية) تحدّد علامة واحدة أو أكثر لإرفاقها بالصورة في مواقع جغرافية محدّدة. تأخذ هذه المَعلمة تعريف علامة واحدة مع مَعلمات مفصولة بحرف الخط العمودي (|). يمكن وضع علامات متعددة ضمن مَعلمةmarkersنفسها طالما أنّها تعرض النمط نفسه. يمكنك إضافة علامات أخرى بأنماط مختلفة من خلال إضافة مَعلماتmarkersأخرى. يُرجى العِلم أنّه في حال تقديم علامات لخريطة، لن تحتاج إلى تحديد المَعلمتَينcenterوzoom(المطلوبتَين عادةً). لمزيد من المعلومات، يُرجى الاطّلاع على علامات Maps Static API.path(اختياري) يحدّد مسارًا واحدًا لنقطتَين متصلتَين أو أكثر لتراكبهما على الصورة في مواقع جغرافية محدّدة. تأخذ هذه المَعلمة سلسلة من تعريفات النقاط مفصولة بحرف التوجيه (|)، أو خطوط متعدّدة مرمّزة باستخدام البادئةenc:ضمن بيان الموقع الجغرافي للمسار. يمكنك تقديم مسارات إضافية من خلال إضافة مَعلماتpathإضافية. يُرجى العِلم أنّه في حال تقديم مسار لخريطة، لن تحتاج إلى تحديد المَعلمتَينcenterوzoom(المطلوبتَين عادةً). لمزيد من المعلومات، يُرجى الاطّلاع على مسارات Maps Static API.visible(اختيارية) تحدّد موقعًا جغرافيًا واحدًا أو أكثر يجب أن يظل مرئيًا على الخريطة، مع العلم أنّه لن يتم عرض أي علامات أو مؤشرات أخرى. استخدِم هذه المَعلمة لضمان عرض ميزات أو مواقع جغرافية معيّنة على الخريطة في Maps Static API.style(اختياري) يحدّد نمطًا مخصّصًا لتغيير طريقة عرض ميزة معيّنة (الطرق والمتنزّهات والميزات الأخرى) على الخريطة. تتطلّب هذه المَعلمة وسيطتَيfeatureوelementلتحديد العناصر التي سيتم تصميمها، ومجموعة من عمليات التصميم التي سيتم تطبيقها على العناصر المحدّدة. يمكنك تقديم أنماط متعددة من خلال إضافة مَعلماتstyleإضافية. لمزيد من المعلومات، يُرجى الاطّلاع على دليل الخرائط ذات التصميم الخاص.
مَعلمات المفتاح والتوقيع
- يتيح لك
key(مطلوب) مراقبة استخدام تطبيقك لواجهة برمجة التطبيقات في وحدة تحكّم Google Cloud، ويضمن أن تتمكّن Google من التواصل معك بشأن تطبيقك إذا لزم الأمر. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام مفاتيح واجهة برمجة التطبيقات مع Maps Static API. signature(يُنصح به) هو توقيع رقمي يُستخدَم للتحقّق من أنّ أي موقع إلكتروني يُنشئ طلبات إنشاء باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك لديه الإذن بإجراء ذلك. قد يتعذّر تنفيذ الطلبات التي لا تتضمّن توقيعًا رقميًا. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام توقيع رقمي.
القيود المفروضة على حجم عنوان URL
يجب ألا يزيد حجم عناوين URL في Maps Static API عن 16,384 حرفًا. من الناحية العملية، لن تحتاج على الأرجح إلى عناوين URL أطول من ذلك، إلا إذا كنت تنشئ خرائط معقّدة تحتوي على عدد كبير من العلامات والمسارات.
استخدام المَعلمات
تتميّز واجهة Maps Static API بسهولة استخدامها نسبيًا، لأنّها تتألف فقط من عنوان URL يتضمّن مَعلمات. يشرح هذا القسم كيفية استخدام هذه المعلمات لإنشاء عناوين URL.
تحديد المواقع الجغرافية
يجب أن تتمكّن Maps Static API من تحديد المواقع الجغرافية بدقة على الخريطة، وذلك لتركيز الخريطة على الموقع الجغرافي الصحيح (باستخدام المَعلمة center) و/أو وضع أي علامات اختيارية (باستخدام المَعلمة markers) في المواقع الجغرافية على الخريطة. تستخدم Maps Static API
أرقامًا (قيم خطوط العرض والطول) أو سلاسل (عناوين)
لتحديد هذه المواقع الجغرافية. تحدّد هذه القيم موقعًا جغرافيًا مُرمّزًا.
تتطلّب عدة مَعلمات (مثل مَعلمتَي markers وpath) مواقع جغرافية متعددة. وفي هذه الحالات، يتم الفصل بين المواقع الجغرافية
باستخدام حرف الخط العمودي (|).
خطوط العرض وخطوط الطول
يتم تحديد خطوط العرض وخطوط الطول باستخدام أرقام ضمن سلسلة نصية مفصولة بفواصل، وتكون دقتها 6 منازل عشرية. على سبيل المثال، "40.714728,-73.998672" هي قيمة رمز جغرافي صالحة. يتم تجاهل الدقة التي تتجاوز 6 خانات عشرية.
تستند قيم خطوط الطول إلى المسافة من غرينتش، إنجلترا، موطن خط الطول الرئيسي. بما أنّ "غرينتش" تقع عند خط العرض 51.477222، يمكننا
إدخال قيمة center تبلغ 51.477222,0 لتوسيط
الخريطة على "غرينتش":
يجب أن تتوافق قيم خطوط العرض والطول مع موقع جغرافي صالح على
سطح الأرض. يمكن أن تأخذ خطوط العرض أي قيمة بين -90 و90، بينما يمكن أن تأخذ قيم خطوط الطول أي قيمة بين -180 و180. إذا حدّدت قيمة غير صالحة لخط العرض أو خط الطول، سيتم رفض طلبك باعتباره طلبًا غير صالح.
العناوين
لا يتحدث معظم الأشخاص بخطوط العرض وخطوط الطول، بل يشيرون إلى المواقع الجغرافية باستخدام العناوين. تُعرف عملية تحويل العنوان إلى نقطة جغرافية باسم الترميز الجغرافي، ويمكن لخدمة Maps Static API إجراء الترميز الجغرافي نيابةً عنك إذا قدّمت عناوين صالحة.
في أي مَعلمة يمكنك فيها تقديم خط عرض/خط طول، يمكنك بدلاً من ذلك تحديد سلسلة تشير إلى عنوان. ستعمل Google على الترميز الجغرافي للعنوان وتزويد خدمة Maps Static API بقيمة خط العرض/خط الطول لاستخدامها في وضع العلامات أو تحديد المواقع. يجب أن تكون السلسلة مشفّرة بعنوان URL، لذا يجب تحويل العناوين مثل "City Hall, New York, NY" إلى "City+Hall,New+York,NY"، على سبيل المثال.
يُرجى العِلم أنّ العناوين قد تشير إلى مواقع جغرافية دقيقة، مثل عناوين الشوارع، أو خطوط متعدّدة مثل المسارات المُسمّاة، أو مناطق مضلّعة مثل المدن أو البلدان أو المتنزّهات الوطنية. بالنسبة إلى النتائج المتعددة الخطوط والمضلّعة، سيستخدم خادم 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 ليشمل الكرة الأرضية بأكملها.
يضاعف كل مستوى تكبير لاحق الدقة في كل من الأبعاد الأفقية والرأسية. تتوفّر المزيد من المعلومات حول كيفية إجراء ذلك في مستندات Google Maps JavaScript API.
ملاحظة: لا تظهر جميع مستويات التكبير في جميع المواقع الجغرافية على الأرض. تختلف مستويات التكبير حسب الموقع الجغرافي، لأنّ البيانات في بعض أجزاء العالم تكون أكثر تفصيلاً من غيرها.
إذا أرسلت طلبًا للحصول على مستوى تكبير لا يتضمّن أي مربّعات خريطة، ستعرض 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 بكسل في البوصة (بكسل لكل بوصة)، ستكون الخريطة بدقة 200 × 200 حوالي 2 بوصة في كل بُعد.
ومع ذلك، تتضمّن الأجهزة الجوّالة بشكل متزايد شاشات عالية الدقة مع كثافة بكسل تزيد عن 300 بكسل في البوصة، والتي إما:
- تقليل حجم صورة بدقة 200×200 بكسل إلى 0.7 بوصة فقط، ما يجعل التصنيفات والرموز صغيرة جدًا بحيث لا يمكن قراءتها
- تغيير حجم الصورة (تكبيرها) لتحسين إمكانية قراءتها، ما يؤدي إلى ظهور صورة غير واضحة أو منقطة
| صغير جدًا | غير واضحة جدًا |
|---|---|
 |
 |
عند تطوير تطبيقات للأجهزة الجوّالة، يمكنك استخدام المَعلمة scale في واجهة برمجة التطبيقات لعرض صور خرائط بدقة أعلى تحلّ المشاكل المذكورة أعلاه. يتم ضرب قيمة scale في size لتحديد حجم الناتج الفعلي للصورة بالبكسل، بدون تغيير نطاق تغطية الخريطة. القيمة التلقائية لسمة scale هي 1، والقيم المقبولة هي 1 و2.
على سبيل المثال، ستعرض قيمة المقياس 2 منطقة تغطية الخريطة نفسها التي يعرضها طلب بدون تحديد مقياس، ولكن مع ضعف عدد وحدات البكسل في كل سمة. ويشمل ذلك الطرق والتصنيفات، بحيث تكون مقروءة على الشاشات ذات الدقة العالية والصغيرة الحجم، وكذلك عند تغيير حجمها من خلال المتصفّح.
| 150x150 | 150x150&scale=2 |
|---|---|
 |
 |
ستظهر هذه الصورة أيضًا بشكل جيد على المتصفّحات المتوافقة مع أجهزة الكمبيوتر المكتبي عند إدراجها في علامة img أو div مع ضبط الارتفاع والعرض باستخدام CSS. سيصغّر المتصفّح الصورة إلى الحجم الصحيح بدون أن تفقد جودتها.
يعرض هذا الجدول ثلاثة طلبات صور مختلفة.
- الأول لصورة بحجم 100×100، بدون تحديد قيمة المقياس. ويتم عرضه بشكل صحيح على أجهزة الكمبيوتر المكتبي، ولكنه صغير جدًا بحيث لا يمكن قراءته على الأجهزة الجوّالة.
- يضاعف الثاني حجم الخريطة. على أجهزة الكمبيوتر المكتبي، يضبط CSS حجم الصورة لتلائم عنصر
imgبحجم 100x100، ولكن عند تصغير حجم الصورة، تصبح الطرق والتصنيفات صغيرة جدًا. على الجهاز الجوّال، تكون الصورة بالحجم المناسب، ولكن الطرق والتصنيفات غير مقروءة مرة أخرى. - الطلب الثالث هو لخريطة بحجم 100x100 مع
scale=2. يتم عرض الصورة بدقة 200 بكسل، ويصغّرها متصفّح أجهزة الكمبيوتر المكتبي بشكل مثالي، بحيث لا يمكن تمييزها عن الطلب الأصلي بدقة 100x100، بينما يستفيد متصفّح الأجهزة الجوّالة من الدقة الإضافية التي تعرضها واجهة برمجة التطبيقات.
| طلبات الصور | |||
|---|---|---|---|
| الجهاز | 100x100 |
200x200 |
100x100&scale=2 |
| أجهزة الكمبيوتر المكتبية (مع السمتَين height="100px" وwidth="100px" في علامةimg) |
 |
 |
 |
| دقة عالية (محاكاة) |
 |
|
|
لمزيد من المعلومات حول تطوير التطبيقات للأجهزة الجوّالة والشاشات ذات الدقة العالية، ننصحك بقراءة ما يلي:
- دعم الشاشات المتعددة في مستندات مطوّري برامج Android
- اقتراحات Webkit.org لتطوير مواقع إلكترونية ذات عدد نقاط لكل بوصة مرتفع
- دعم الشاشات العالية الدقة في مكتبة مطوّري iOS
تنسيقات الصور
يمكن عرض الصور بعدة تنسيقات رسومات ويب شائعة: 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 غير المتدرّج.
أنواع الخرائط
تنشئ 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=markerStyles|markerLocation1|
markerLocation2|... وما إلى ذلك
يتم الإعلان عن مجموعة markerStyles في بداية تعريف markers وتتألف من صفر أو أكثر من واصفات الأنماط مفصولة بحرف الشرطة المستقيمة (|)، متبوعة بمجموعة من موقع واحد أو أكثر مفصولة أيضًا بحرف الشرطة المستقيمة (|).
بما أنّه يتم تحديد معلومات النمط ومعلومات عن الموقع الجغرافي للجهاز من خلال حرف الخط العمودي، يجب أن تظهر معلومات النمط أولاً في أي واصف علامة. بعد أن يواجه خادم Maps Static 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. ومع ذلك، إذا لم يتم توفير هذه المَعلمات، سينشئ خادم Maps Static 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، وعلامة خضراء صغيرة واحدة عند "دلتا جنكشن، ألاسكا"، وعلامة صفراء متوسطة الحجم تحمل التصنيف "C" عند "توك، ألاسكا". تظهر هذه العلامات في المثال التالي:
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، مثل 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 رموزًا مخصّصة ويضعها باستخدام نقاط الارتساء.
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
مسارات Maps Static API
تحدّد المَعلمة path مجموعة من موقع جغرافي واحد أو أكثر
مرتبطة بمسار يظهر على صورة الخريطة. تأخذ المَعلمة path مجموعة من عمليات تحديد القيم (أوصاف المسارات) بالتنسيق التالي:
path=pathStyles|pathLocation1|pathLocation2|... وما إلى ذلك
يُرجى العِلم أنّه يتم الفصل بين نقطتَي المسار باستخدام حرف الخط العمودي (|). وبما أنّه يتم الفصل بين معلومات النمط ومعلومات النقاط باستخدام حرف الخط العمودي، يجب أن تظهر معلومات النمط أولاً في أي واصف مسار. عندما يواجه خادم Maps Static 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:(اختيارية) إلى أنّ المسار يحدّد منطقة مضلّعة، وتحدّد لون التعبئة الذي سيتم استخدامه كتراكب داخل تلك المنطقة. لا يلزم أن تكون مجموعة المواقع الجغرافية التالية حلقة "مغلقة"، لأنّ خادم 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 من "يونيون سكوير" في نيويورك إلى "تايمز سكوير" في نيويورك.
في ما يلي تفاصيل المَعلمة 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¢er=59.900503,-135.478011&zoom=4 &path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU%7D%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA%7Df%5BroaAynd@%7CvXxiAt%7BZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k%7Bg@i%60%5Do%7CF%7DvXaj%5Ch%60%5Dovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh%60%5Dv%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez%5C_%7BKm_%60@~re@ew%5ErcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr%7BZlwBrvdAmtHrmT%7BrOt%7BZz%7DE%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@%60%60NrfQpcHrb%5Ek%7CDh_z@nwB%7Ckb@a%7BR%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY%7Dt%5Dhuf@e%7CFria@o%7DGfezAkdW%7C%7D%5BocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C%60l@uoJrvdAgq@fppAsjGhg%60@%7ChQpg%7BAi_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C%7D%5Bmv%60@t_NitSfjp@c%7DMhg%60@sbChyYq%7De@rwg@atFff%7D@ghN~zKybk@fl%7DA%7DcPftcAite@tmT__Lha@u~DrfQi%7DMhkSqyWivIumCria@ciO_tHifm@fl%7DA%7Brc@fbjAqvg@rrqAcjCf%7Ci@mqJtb%5Es%7C@fbjA%7BwDfs%60BmvEfqs@umWt_Nwn%5Epen@qiBr%60xAcvMr%7BZidg@dtjDkbM%7Cd_@ &key=YOUR_API_KEY&signature=YOUR_SIGNATURE
كما هو الحال مع المسارات العادية، قد تحدّد مسارات الخطوط المتعددة المرمّزة أيضًا مناطق مضلّعة إذا تم تمرير وسيطة fillcolor إلى المَعلمة path.
يوضّح المثال التالي منطقة مضلّعة في بروكلين، نيويورك:
https://maps.googleapis.com/maps/api/staticmap ?size=400x400¢er=40.653279,-73.959816&zoom=11 &path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:%7DzswFtikbMjJzZ%7CRdPfZ%7DDxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz%40bIx%7BA%7CPfYlvApz%40bl%40tcAdTpGpVwQtX%7Di%40%7CGen%40lCeAda%40bjA%60q%40v%7D%40rfAbjA%7CEwBpbAd_%40he%40hDbu%40uIzWcWtZoTdImTdIwu%40tDaOXw_%40fc%40st%40~VgQ%7C%5BuPzNtA%60LlEvHiYyLs%5EnPhCpG%7DSzCNwHpz%40cEvXg%40bWdG%60%5DlL~MdTmEnCwJ%5BiJhOae%40nCm%5B%60Aq%5DqE_pAaNiyBuDurAuB%7D%7DAy%60%40%7CEKv_%40%3F%7C%5BqGji%40lAhYyH%60%40Xiw%40tBerAs%40q%5DjHohAYkSmW%3FaNoaAbR%7DLnPqNtMtIbRyRuDef%40eT_z%40mW_Nm%7CB~j%40zC~hAyUyJ_U%7BZ%3F%3FcPvg%40%7Ds%40sHsc%40_z%40cj%40kp%40YePoNyYyb%40_iAyb%40gBw%5EbOokArcA%7DGwJuzBre%40i%5Ctf%40sZnd%40oElb%40hStW%7B%5Dvv%40%3F%3Fkz%40~vAcj%40zKa%60Atf%40uQj_Aee%40pU_UrcA &key=YOUR_API_KEY&signature=YOUR_SIGNATURE
إطارات العرض
يمكن أن تحدّد الصور إطار عرض من خلال تحديد المواقع الجغرافية المرئية باستخدام المَعلمة visible. توجّه المَعلمة visible خدمة Maps Static API لإنشاء خريطة بحيث تظل المواقع الجغرافية الحالية مرئية. (يمكن دمج هذه المَعلمة مع العلامات أو المسارات الحالية لتحديد منطقة مرئية أيضًا). يؤدي تحديد إطار العرض بهذه الطريقة إلى تجنُّب الحاجة إلى تحديد مستوى تكبير دقيق.
يطلب المثال التالي خريطة تتمحور حول بوسطن، ماساتشوستس، وتحتوي على كل من معهد ماساتشوستس للتكنولوجيا وساحة هارفارد في كامبريدج، ماساتشوستس:
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" (مثل Maps JavaScript API أو Maps Embed API أو "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android" أو "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع iOS") وسبب عدم تلبيتها لاحتياجاتك
- لقطات شاشة أو نماذج تجريبية أو عيّنات توضّح كيفية استخدام الصور الكبيرة الحجم
- الاستخدام الشهري المقدَّر للصور الكبيرة الحجم
سنراجع طلبك استنادًا إلى المعلومات التي تقدّمها ونحدّد ما إذا كانت حالة الاستخدام تتوافق مع بنود خدمة "منصة خرائط Google".
الحدّ الأقصى للحجم الذي يمكننا توفيره هو 2048 × 2048 بكسل.
تحديد المشاكل وحلّها والحصول على الدعم
لمزيد من المعلومات حول استخدام Maps Static API، يُرجى الاطّلاع على صفحة الدعم.
قد تُصدر Maps Static API خطأً أو تحذيرًا عند حدوث خطأ ما. يجب التحقّق من التحذيرات، خاصةً إذا لاحظت أنّ هناك بيانات مفقودة من الخريطة. من الأفضل أيضًا التحقّق من التحذيرات قبل إطلاق تطبيق جديد. يُرجى العِلم أنّ التحذيرات قد لا تظهر على الفور لأنّها تظهر في عنوان HTTP. لمزيد من المعلومات، يمكنك الاطّلاع على دليل الأخطاء والتحذيرات.