قد تُصدر واجهة برمجة التطبيقات Maps Static API خطأ أو تحذيرًا عند حدوث مشكلة. يوضّح هذا الدليل كل رسالة خطأ، ويقدّم المزيد من الخطوات المتعلّقة بحلّ الأخطاء.
الطلبات غير الصالحة
في حال تلقّي طلب غير صالح، تعرض واجهة برمجة التطبيقات Maps Static API
رمز حالة HTTP 4xx ورسالة تصف
المشكلة. في ما يلي أمثلة على حالات الخطأ هذه. ملاحظة: هذه ليست
قائمة شاملة بالأخطاء المحتمَلة. يُرجى التحقّق من رمز الخطأ
والرسالة الفعلية التي تعرضها واجهة برمجة التطبيقات للحصول على تفاصيل عن المشاكل المحدّدة.
| مثال على حالة الخطأ | رمز الحالة |
|---|---|
يتضمّن الطلب مَعلمة غير صالحة، أو هناك مَعلمة مطلوبة مفقودة. على سبيل المثال، لا تقع المَعلمة size ضمن
النطاق المتوقّع للقيم الرقمية، أو تكون غير متوفّرة في الطلب. |
400 BAD REQUEST |
| مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح. | 403 FORBIDDEN |
الأخطاء التي تمنع عرض الخريطة
إذا كان الطلب صالحًا، ولكن حدث خطأ آخر يمنع عرض الخريطة، ستعرض واجهة برمجة التطبيقات Maps Static API إما نصًا أو صورة خطأ بدلاً من الخريطة، وذلك استنادًا إلى الخطأ. على سبيل المثال، أحد حالات الخطأ هذه هي عندما يتجاوز التطبيق حدود الاستخدام.
الأخطاء المرتبطة بمفاتيح واجهة برمجة التطبيقات والفوترة
إذا كنت تستخدم واجهة برمجة التطبيقات "الخرائط الثابتة" بدون مفتاح واجهة برمجة التطبيقات، أو إذا لم تكن الفوترة مفعّلة في حسابك، ستعرض الصفحة صورة خطأ بدلاً من ملف تضاريس، مع رابط يشير إلى نوع الخطأ. على سبيل المثال، "g.co/staticmaperror/key".
| الأخطاء المتعلّقة بنظام "فتح السيارة بدون مفتاح" وحلولها | |
|---|---|
 |
استخدام واجهة برمجة التطبيقات Maps Static API بدون مفتاح واجهة برمجة التطبيقات لحلّ هذه المشكلة، عليك: |
 |
لا يتضمّن طلبك توقيعًا رقميًا (مطلوب). لحلّ هذه المشكلة، وقِّع على عنوان 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 أو أدوات أخرى مماثلة في المتصفّح.