مقدمة
تعرض Maps Static API صورة (إما GIF أو PNG أو JPEG) كاستجابة لطلب HTTP من خلال عنوان URL. بالنسبة إلى كل طلب، يمكنك تحديد موقع الخريطة وحجم الصورة ومستوى التكبير/التصغير ونوع الخريطة وموضع العلامات الاختيارية في المواقع على الخريطة. يمكنك أيضًا تسمية العلامات باستخدام أحرف أبجدية رقمية.
يتم تضمين صورة من Maps Static API في السمة src
للعلامة <img>
، أو ما يعادلها في لغات برمجة أخرى.
يصف هذا المستند التنسيق المطلوب لعناوين URL لواجهة برمجة تطبيقات الخرائط الثابتة والمعلمات المتاحة. كما تشير أيضًا إلى بعض النصائح والحيل في تحديد عناوين URL.
قبل البدء
هذا المستند مخصّص لمطوّري المواقع الإلكترونية ومطوّري الأجهزة الجوّالة الذين يريدون تضمين صور واجهة برمجة التطبيقات الثابتة لخدمة "خرائط Google" في صفحة ويب أو تطبيق متوافق مع الأجهزة الجوّالة. وهي تقدّم مقدمة عن استخدام واجهة برمجة التطبيقات والمواد المرجعية في المعلَمات المتاحة.
قبل البدء في التطوير باستخدام 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، يتم فصل جميع المعلمات باستخدام حرف العطف (&
). يتم سرد قائمة المعلمات وقيمها
المحتملة في هذا المستند.
تحدد 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
(اختيارية) تنسيق الصورة الناتجة. بشكل افتراضي، تنشئ Maps Static API صور PNG. هناك العديد من التنسيقات الممكنة، بما في ذلك أنواع GIF وJPEG وPNG. ويعتمد التنسيق الذي تستخدمه على الطريقة التي تنوي عرض الصورة بها. توفّر ملفات JPEG عادةً ضغطًا أكبر، في حين توفّر ملفات GIF وPNG تفاصيل أكثر. لمزيد من المعلومات، اطّلِع على تنسيقات الصور. - تحدّد السمة
maptype
(اختيارية) نوع الخريطة المطلوب إنشاؤها. هناك عدة قيم محتملة لنوع الخريطة، بما في ذلكroadmap
وsatellite
وhybrid
وterrain
. للمزيد من المعلومات، راجع أنواع الخرائط الثابتة لواجهة برمجة التطبيقات للخرائط. language
(اختيارية) تحدد اللغة المستخدمة لعرض التصنيفات على مربعات الخريطة. يُرجى العلم بأنّ هذه المَعلمة متاحة فقط لبعض مربّعات البلدان، فإذا كانت اللغة المحدّدة المطلوبة غير متوافقة مع مجموعة المربّعات، سيتم استخدام اللغة التلقائية لمجموعة المربّعات هذه.- تحدد السمة
region
(اختيارية) الحدود المناسبة التي يمكن عرضها استنادًا إلى الحساسيات الجغرافية السياسية. ويتم قبول رمز المنطقة المحدد كقيمة ccTLD مكوَّنة من حرفين ("نطاق المستوى الأعلى"). يمكنك الاطّلاع على تفاصيل تغطية "منصة خرائط Google" لمعرفة المناطق التي تتوفّر فيها الخدمة.
معلمات الميزات
map_id
(اختيارية) تحدّد المعرّف لخريطة معيّنة. يربط معرّف الخريطة خريطة بنمط أو ميزة معيّنة، ويجب أن ينتمي إلى المشروع نفسه الذي ينتمي إليه مفتاح واجهة برمجة التطبيقات المُستخدَم لإعداد الخريطة. لمزيد من المعلومات، راجع استخدام أرقام تعريف الخرائط.markers
(اختياري) حدِّد علامة واحدة أو أكثر لإرفاقها بالصورة في مواقع محدّدة. تستخدم هذه المَعلمة تعريف علامة واحدًا مع معلَمات مفصولة برمز الممر (|
). يمكن وضع عدة علامات ضمن المعلَمةmarkers
نفسها ما دامت تعرض النمط نفسه. يمكنك إضافة علامات أخرى لأنماط مختلفة من خلال إضافة معلَماتmarkers
إضافية. يُرجى العِلم أنّه إذا قدّمت علامات لخريطة، لن تحتاج إلى تحديد المَعلمتَينcenter
وzoom
(المطلوبتَين عادةً). لمزيد من المعلومات، اطّلِع على علامات واجهة برمجة التطبيقات الثابتة للخرائط.- تحدّد السمة
path
(اختيارية) مسارًا واحدًا مكونًا من نقطتَين مرتبطتَين أو أكثر من أجل تركيب الصورة على الصورة في مواقع جغرافية محدّدة. تستخدم هذه المَعلمة سلسلة من تعريفات النقاط مفصولة بحرف الشرطة المستقيمة (|
)، أو خطًا متعددًا مشفّرًا باستخدام البادئةenc:
ضمن تعريف الموقع للمسار. يمكنك توفير مسارات إضافية عن طريق إضافة مَعلماتpath
إضافية. يُرجى العِلم أنّك إذا قدّمت مسارًا للخريطة، لن تحتاج إلى تحديد المَعلمتَينcenter
وzoom
(المطلوبتَين عادةً). لمزيد من المعلومات، اطّلِع على مسارات واجهة برمجة التطبيقات الثابتة للخرائط. visible
(اختيارية) تحدد موقعًا جغرافيًا واحدًا أو أكثر يجب أن يظل مرئيًا على الخريطة، ولكن لن يتم عرض أي علامات أو مؤشرات أخرى. استخدِم هذه المَعلمة لضمان عرض ميزات أو مواقع جغرافية معيّنة على الخريطة في Maps Static API.- تحدّد السمة
style
(اختيارية) نمطًا مخصّصًا لتغيير طريقة عرض عنصر معيّن (الطرق والمتنزهات والعناصر الأخرى) في الخريطة. تستخدم هذه المعلَمة الوسيطاتfeature
وelement
التي تحدّد الميزات المطلوب تصميمها، بالإضافة إلى مجموعة من عمليات الأنماط لتطبيقها على الميزات المحدّدة. يمكنك توفير أنماط متعددة من خلال إضافة مَعلماتstyle
إضافية. لمزيد من المعلومات، راجع دليل الخرائط ذات الأنماط.
معلمات المفتاح والتوقيع
key
(مطلوب) يسمح لك بمراقبة استخدام تطبيقك لواجهة برمجة التطبيقات في Google Cloud Console، ويضمن إمكانية تواصل Google معك بشأن تطبيقك إذا لزم الأمر. لمزيد من المعلومات، اطّلِع على المقالة استخدام مفاتيح واجهة برمجة التطبيقات مع واجهة برمجة التطبيقات الثابتة لتطبيق "خرائط Google".signature
(مقترَح) هو توقيع رقمي يُستخدم للتحقق من أنّ أي طلبات ينشئها الموقع الإلكتروني باستخدام مفتاح واجهة برمجة التطبيقات مسموح بها لتنفيذ ذلك. وقد يتعذّر تنفيذ الطلبات التي لا تتضمّن توقيعًا رقميًا. لمزيد من المعلومات، يمكنك الاطّلاع على استخدام توقيع رقمي.
تقييد حجم عنوان URL
يقتصر حجم عناوين URL لواجهة برمجة التطبيقات الثابتة للخرائط على 16384 حرفًا. من الناحية العملية، لن تحتاج على الأرجح إلى عناوين URL أطول من ذلك، إلا إذا كنت تنشئ خرائط معقّدة تحتوي على عدد كبير من العلامات والمسارات.
استخدام المَعلمة
يتميز Maps Static API بسهولة الاستخدام نسبيًا، لأنّه يتكوّن فقط من عنوان URL يتضمّن معلَمات. يوضّح هذا القسم كيفية استخدام هذه المعلمات لإنشاء عناوين URL.
تحديد المواقع
يجب أن تتمكّن واجهة برمجة التطبيقات الثابتة للخرائط من تحديد المواقع الجغرافية على الخريطة بدقة، لتركيز الخريطة على الموقع الجغرافي الصحيح (باستخدام المَعلمة center
) و/أو وضع أي علامات موضعية اختيارية (باستخدام المَعلمة markers
) في المواقع الجغرافية على الخريطة. تستخدم Maps Static API الأرقام (قيم خطوط الطول والعرض) أو السلاسل (العناوين)
لتحديد هذه المواقع. تحدد هذه القيم موقعًا جغرافيًا.
وتتوفّر عدّة معلَمات (مثل المَعلمتَين markers
وpath
) في مواقع جغرافية متعددة. في تلك الحالات، يتم فصل المواقع
باستخدام حرف الممر (|
).
خطوط العرض والطول
يتم تحديد خطوط العرض والطول باستخدام أرقام داخل سلسلة نصية مفصولة بفواصل بدقة 6 أماكن عشرية. على سبيل المثال، "40.714728,-73.998672" هي قيمة رمز جغرافي صالحة. ويتم تجاهل الدقة التي تتجاوز المنازل العشرية الست.
تستند قيم خط الطول إلى المسافة من غرينتش، إنجلترا، موطن خط الطول الرئيسي. ولأنّ غرينتش تقع على خط العرض 51.477222، يمكننا إدخال القيمة center
بقيمة 51.477222,0
لتوسيط الخريطة على غرينتش:
يجب أن تتوافق قيم خطوط الطول والعرض مع موقع صالح على سطح الأرض. يمكن أن تتراوح قيمة خطوط العرض بين -90
و90
، بينما يمكن أن تتراوح قيم خطوط الطول بين -180
و180
. إذا حددت قيمة خط طول أو خط عرض غير صالحة،
فسيتم رفض طلبك باعتباره طلبًا غير صالح.
العناوين
معظم الأشخاص لا يتحدّثون باستخدام خطوط الطول والعرض، بل يشيرون إلى المواقع الجغرافية باستخدام العناوين. تُعرف عملية تحويل العنوان إلى نقطة جغرافية باسم الترميز الجغرافي ويمكن لخدمة Maps Static API تنفيذ الترميز الجغرافي نيابةً عنك إذا قدّمت عناوين صالحة.
في أي معلمة يمكنك فيها تقديم خط عرض/خط طول، يمكنك بدلاً من ذلك تحديد سلسلة تشير إلى عنوان. ستعمل 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 (يُعرض بدقة 1280x1280 بكسل) |
يطلب هذا المثال "شريحة" من الأرض عند خط الاستواء عند مستوى التكبير/التصغير 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)، ستكون الخريطة مقاس 200 x 200
حوالي 2 بوصة في كل بُعد.
ومع ذلك، تتضمّن الأجهزة الجوّالة بشكل متزايد شاشات عالية الدقة وبكثافة وحدات بكسل تزيد عن 300 بكسل في البوصة، وهي أيًا ممّا يلي:
- قلِّل حجم صورة بحجم 200×200 بكسل إلى 0.7 بوصة فقط، بحيث تكون التسميات والرموز صغيرة جدًا بحيث لا يمكن قراءتها.
- تعديل حجم الصورة (تكبيرها/تصغيرها) لتحسين سهولة قراءة الصورة، ما يؤدي إلى ظهور صورة ضبابية أو متقطّعة
صغير جدًا | ضبابي للغاية |
---|---|
![]() |
![]() |
عند التطوير للأجهزة الجوّالة، يمكنك استخدام مَعلمة scale
الخاصة بواجهة برمجة التطبيقات لعرض صور خرائط بدقة أعلى تحل المشاكل الواردة أعلاه. يتم ضرب القيمة scale
في size
لتحديد حجم الإخراج الفعلي للصورة بالبكسل، بدون تغيير مساحة التغطية على الخريطة. القيمة التلقائية للسمة scale
هي 1، والقيم المقبولة هي 1 و2.
على سبيل المثال، ستعرض قيمة المقياس 2 منطقة تغطية الخريطة نفسها كطلب بدون تحديد مقياس، ولكن سيتم عرض ضعف عدد وحدات البكسل في كل سمة. ويشمل ذلك الطرق والتصنيفات، بحيث يمكن قراءتها على الشاشات ذات الدقة العالية والصغيرة الحجم، وكذلك عند تغيير حجمها بواسطة المتصفح.
150 × 150 | 150×150&مقياس=2 |
---|---|
![]() |
![]() |
ستحقق هذه الصورة أداءً جيدًا أيضًا على المتصفّحات المتوافقة مع أجهزة الكمبيوتر المكتبي عند إدراجها في علامة img
أو div
مع ضبط الارتفاع والعرض باستخدام CSS. سيقلّل المتصفّح حجم الصورة إلى الحجم الصحيح،
بدون أن يفقد جودتها.
يعرض هذا الجدول ثلاثة طلبات صور مختلفة.
- الأول مخصص لصورة مقاس 100×100، بدون تحديد قيمة مقياس. يتم عرض المحتوى بشكل صحيح على الكمبيوتر المكتبي، ولكنّه صغير جدًا ولا يمكن قراءته على الأجهزة الجوّالة.
- وتضاعف الطريقة الثانية حجم الخريطة. على جهاز سطح المكتب، يتناسب محتوى CSS مع العنصر
img
المحدّد بمقاس 100x100، إلا أنّه عند تصغير حجم الصورة، تصبح الطرق والتصنيفات صغيرة جدًا. وعلى الجهاز الجوّال، تكون الصورة بالحجم الصحيح، ولكن الطرق والتسميات غير واضحة مرة أخرى. - الطلب الثالث هو خريطة 100×100 مع
scale=2
. يتم عرض الصورة مع تفاصيلها 200 بكسل، بينما يصغر حجمها على الكمبيوتر المكتبي بشكل مثالي، بحيث لا يمكن تمييزها عن الطلب الأصلي 100×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
تنسيق 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:
(اختياري) تحدد حرفًا أبجديًا رقميًا واحدًا كبيرًا من المجموعة {A-Z, 0-9}. (شرط استخدام الأحرف الكبيرة جديد في هذا الإصدار من واجهة برمجة التطبيقات). يُرجى العِلم أنّ العلامات التلقائية وذات الحجمmid
هي العلامات الوحيدة التي يمكنها عرض المَعلمةalphanumeric-character
. يتعذّر على علامتَيtiny
وsmall
عرض أحرف أبجدية رقمية.
تغيير حجم العلامة
يتم ضرب قيمة scale
في حجم صورة العلامة
لإنتاج حجم الإخراج الفعلي للعلامة بالبكسل. قيمة المقياس الافتراضية هي 1؛ القيم المقبولة هي 1 و2 و4.
يتم تطبيق حد حجم البكسل في الصور بعد تطبيق تغيير الحجم. على سبيل المثال، إذا تم تعيين العلامة على scale:2
، فإن العلامة يمكن أن تكون أكبر من الحد الأقصى للحجم الذي يبلغ 4096 بكسل، طالما أنها تقل إلى أقل من 4096 بكسل بعد تغيير الحجم. استخدم تغيير حجم العلامة جنبًا إلى جنب مع تحجيم الخريطة عند عرض خرائط عالية الدقة.
مواقع العلامات
يجب أن يحتوي كل واصف للعلامة على مجموعة من موقع واحد أو أكثر يحدد مكان وضع العلامة على الخريطة. يمكن تحديد هذه المواقع إما كقيم خطوط الطول/العرض أو كعناوين. يتم فصل هذه المواقع باستخدام
رمز الممر (|
).
ملاحظة: إذا اخترت تحديد مواقع العلامات بطريقة تتطلب ترميزًا جغرافيًا، مثل سلاسل العناوين التي يمكن للإنسان أو الخطوط المتعددة قراءتها، يقتصر الطلب على 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،
وعلامة خضراء صغيرة واحدة في "Delta Junction، 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 رموزًا مخصصة ويحدد مواضع الرموز باستخدام علامات الارتساء.
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:
(اختيارية) إلى أنّ المسار يميّز منطقة مضلّعة، كما يحدّد لون التعبئة الذي سيتم استخدامه كتراكب داخل هذه المنطقة. ليس بالضرورة أن تكون مجموعة المواقع الجغرافية التالية حلقة "مغلقة"، لأنّ خادم واجهة برمجة التطبيقات الثابتة للخرائط سينضم تلقائيًا إلى النقطة الأولى والأخيرة. يُرجى العلم أنّ أي شطب على الجزء الخارجي من المنطقة المعبأة لن يتم إغلاقه ما لم تحدّد موقع البداية والنهاية نفسيهما على وجه التحديد. geodesic:
(اختيارية) تشير إلى أنه يجب تفسير المسار المطلوب على أنه خط جيوديسي يتبع انحناء الأرض. أما في حال اختيار القيمة "خطأ"، يتم عرض المسار كخط مستقيم في مساحة الشاشة. الخيار التلقائي هو "خطأ".
إليك بعض الأمثلة على تعريفات المسارات:
- خط أزرق رفيع، وتعتيم بنسبة 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 في نيويورك.
في ما يلي تفاصيل المَعلمة 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
خدمة "واجهة برمجة التطبيقات الثابتة للخرائط" إلى إنشاء خريطة تظلّ المواقع الجغرافية الحالية مرئية. (يمكن دمج هذه المعلمة مع العلامات أو المسارات
الحالية لتحديد منطقة مرئية أيضًا). يؤدي تحديد إطار العرض بهذه الطريقة إلى تجنب الحاجة إلى تحديد مستوى تكبير/تصغير دقيق.
يطلب المثال التالي خريطة تتمحور حول بوسطن بولاية ماساتشوستس تحتوي على كل من معهد ماساتشوستس للتكنولوجيا وميدان هارفارد في كامبريدج، ماساتشوستس:
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. لمزيد من المعلومات، راجِع دليل الأخطاء والتحذيرات.