المقدمة
تعرض واجهة برمجة تطبيقات الخرائط الثابتة صورة (إما 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 ) |
![]() |
![]() |
![]() |
دقة عالية (محاكاة) |
![]() |
![]() |
![]() |
لمزيد من المعلومات عن تطوير التطبيقات المتوافقة مع الأجهزة الجوّالة والشاشات عالية الدقة، ننصحك بقراءة المحتوى التالي:
- إتاحة استخدام شاشات متعددة في مستندات مطوّري برامج Android
- اقتراحات Webkit.org لتطوير مواقع الويب ذات DPI عالية.
- إتاحة استخدام الشاشات عالية الدقة في "مكتبة مطوّري برامج 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
، وهو عرض غير متدرّج.
أنواع الخريطة
تنشئ واجهة برمجة تطبيقات الخرائط الثابتة خرائط بتنسيقات متعددة، مدرجة أدناه:
- تحدّد السمة
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.
تفاصيل المعلَمة 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}%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¢er=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)، فالرجاء الاتصال بفريق الدعم وتقديم المعلومات التالية:
- حالة استخدامك وسبب احتياجك إلى صور كبيرة الحجم
- يمكنك استخدام واجهات برمجة تطبيقات أخرى في "منصة خرائط Google" (واجهة برمجة تطبيقات JavaScript للخرائط أو واجهة برمجة التطبيقات لتضمين الخرائط أو حزمة تطوير برامج "خرائط Google" لأجهزة Android أو حزمة تطوير برامج "خرائط Google" لنظام التشغيل iOS) وتوضيح سبب عدم تلبية هذه المتطلبات.
- لقطات شاشة أو نماذج أو نماذج عن كيفية استخدام الصور كبيرة الحجم.
- الاستخدام الشهري المقدّر للصور كبيرة الحجم
ستتم مراجعة طلبك بناءً على المعلومات التي تقدمها وتحديد ما إذا كانت حالة استخدامك تتوافق مع بنود خدمة Google Maps Platform أم لا.
الحد الأقصى للحجم الذي يمكننا تقديمه هو 2048 × 2048 بكسل.
تحرّي الخلل وإصلاحه والدعم
للحصول على مزيد من المعلومات عن استخدام واجهة برمجة التطبيقات الثابتة للخرائط، يمكنك الاطّلاع على صفحة الدعم.
قد تصدر واجهة برمجة تطبيقات الخرائط الثابتة خطأ أو تحذيرًا عندما يحدث خطأ ما. ويجب أن تتحقق من التحذيرات تحديدًا إذا لاحظت أن هناك شيئًا ما غير موجود في الخريطة. من المفيد أيضًا البحث عن التحذيرات قبل إطلاق تطبيق جديد. يُرجى العِلم بأن التحذيرات قد لا تظهر على الفور لأنها تظهر في عنوان HTTP. ولمزيد من المعلومات، يمكنك الاطّلاع على دليل الأخطاء والتحذيرات.