قد تُصدر واجهة برمجة التطبيقات الثابتة للخرائط خطأً أو تحذيرًا عندما يحدث شيء ما خطأ. يوضّح هذا الدليل كل رسالة خطأ، ويقدّم المزيد من الخطوات المتعلّقة بحلّ الأخطاء.
الطلبات غير الصالحة
في حالة وجود طلب غير صالح، تعرض واجهة برمجة التطبيقات الثابتة للخرائط
رمز حالة HTTP 4xx ورسالة تصف
المشكلة. في ما يلي أمثلة على حالات الخطأ هذه. ملاحظة: هذه ليست
قائمة شاملة بالأخطاء المحتمَلة. يُرجى التحقق من رمز الخطأ الفعلي.
والرسالة التي تعرضها واجهة برمجة التطبيقات للحصول على تفاصيل حول مشاكل محددة.
| مثال على حالة الخطأ | رمز الحالة |
|---|---|
يتضمن الطلب معلَمة غير صالحة، أو تتضمن المعلمة المطلوبة
مفقودة. على سبيل المثال، لا تقع المَعلمة size ضمن
النطاق المتوقّع للقيم الرقمية، أو تكون غير متوفّرة في الطلب. |
400 BAD REQUEST |
| مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح. | 403 FORBIDDEN |
الأخطاء التي تمنع عرض الخريطة
إذا كان الطلب صالحًا، ولكن حدث خطأ آخر يمنع عرض الخريطة، ستعرض واجهة برمجة التطبيقات Maps Static API إما نصًا أو صورة خطأ بدلاً من الخريطة، وذلك استنادًا إلى الخطأ. مثال على هذا الخطأ هو عندما يتجاوز التطبيق حدود الاستخدام.
الأخطاء المتعلقة بمفاتيح واجهة برمجة التطبيقات والفوترة
في حال استخدام واجهة برمجة التطبيقات Maps Static API بدون مفتاح واجهة برمجة التطبيقات، أو في حال كانت الفوترة لم يتم تفعليها في حسابك، فستعرض الصفحة صورة خطأ بدلاً من مع رابط يشير إلى نوع الخطأ. على سبيل المثال: "g.co/staticmaperror/key".
| الأخطاء والحلول بدون مفاتيح | |
|---|---|
 |
أنت تستخدم واجهة برمجة التطبيقات الثابتة للخرائط بدون مفتاح واجهة برمجة التطبيقات. لحلّ هذه المشكلة، عليك: |
 |
لا يتضمّن طلبك توقيعًا رقميًا (مطلوب). لحل المشكلة، توقيع عنوان URL |
تتضمّن تحذيرات
بالنسبة إلى بعض حالات الخطأ، تعرض واجهة برمجة التطبيقات خريطة ولكن قد يتم عرض بعض المعلومات مفقود من الخريطة. عندما يحدث هذا، يحدث شرطان لإخبارك التحذير.
- أولاً، يتم عرض الخريطة، ولكن مع وجود شريط خطأ أصفر متراكب فوق في أعلى الخريطة مع النص "خطأ في الخريطة: g.co/staticmaperror".
- ثانيًا، تعرض واجهة برمجة التطبيقات تحذيرًا في
شكل عنوان HTTP باسم
X-Staticmap-API-Warning.
على سبيل المثال، يحتوي عنوان URL التالي على قيمة غير متوقّعة في المَعلمة
markers:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
تعرض واجهة برمجة التطبيقات خريطة، ولكنها تعرض شريط خطأ أصفر متراكبًا فوق الصورة التي تحتوي على "خطأ في الخريطة: g.co/staticmaperror":
تعرض واجهة برمجة التطبيقات أيضًا عنوان HTTP التالي:
X-Staticmap-API-Warning:Error geocoding: marker 1
يوضّح الجدول التالي التحذيرات التي قد تنشرها واجهة برمجة التطبيقات كرؤوس HTTP: :
التحذيرات في رؤوس X-Staticmap-API-Warning
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
حدث خطأ أثناء محاولة ترميز الطلب جغرافيًا. هناك
العديد من الصيغ لهذه الرسالة، استنادًا إلى العنصر الذي تعذّر فيه تحديد الموقع الجغرافي
(المركز أو العلامة أو العنصر المرئي أو المسار) وعدد العناصر
التي تعذّر فيها تحديد الموقع الجغرافي. أحد الأمثلة على هذا التحذير
X-Staticmap-API-Warning:Error geocoding: marker 1، باسم
كما هو موضح في المثال أعلاه. |
Too many geocoded markers requested (max is 15). |
يحدِّد الطلب أكثر من الحد الأقصى المسموح به لعدد العلامات التي لها عنوان يمكن لشخص عادي قراءته. الحد الأقصى هو 15. تجدر الإشارة إلى أنّ هذا الحدّ الأقصى لا ينطبق إلا على العلامات المحدّدة كعنوان يمكن لشخص عادي قراءته ويتطلب ترميزًا جغرافيًا. ولا ينطبق على العلامات المحددة باستخدام إحداثيات خطوط العرض/خطوط الطول. |
Too many geocoded polyline vertices requested (max is 15). |
يحدِّد الطلب أكثر من الحد الأقصى المسموح به لعدد الخطوط المتعددة التي تتضمّن عنوانًا يمكن لشخص عادي قراءته. الحد الأقصى هو 15. يُرجى العِلم أنّ هذا الحدّ القصوى لا ينطبق إلا على الخطوط المتعددة الأشكال التي تحتوي على رؤوس محدّدة كعناوين قابلة للقراءة من قِبل البشر والتي تتطلّب ترميزًا جغرافيًا. ولا ينطبق ذلك على الخطوط المتعددة المحدّدة باستخدام إحداثيات خطوط الطول/العرض. |
يمكنك الاطّلاع على تحذيرات رؤوس HTTP في وحدة تحكّم أدوات مطوّري برامج Chrome أو Firefox Web Console أو أدوات أخرى مماثلة في المتصفّح.