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