الرئيسية / الأخطاء والحدود
الأخطاء والحدود
ما يعنيه كل رمز حالة، ومتى تعيد المحاولة، وحدود الطلبات والحصة الشهرية.
رموز الحالة
| الحالة | المعنى | ماذا تفعل |
|---|---|---|
| 400 | معاملات خاطئة: InvalidUrl (صيغة lng,lat)، InvalidValue، InvalidOptions (أقل من نقطتين)، TooBig، NoRoute، NoSegment | صحّح الطلب. لا تُعِد المحاولة. |
| 401 | لا مفتاح ولا نطاق مسجّل، أو نطاق مشترك بين عدة مشاريع بدون مفتاح، أو المفتاح خطأ أو ملغى أو منتهٍ. | مشكلة إعدادات. سجّلها ولا تُعِد المحاولة. |
| 403 | المفتاح لا يملك هذه الخدمة، أو أُرسل من نطاق ليس لعميله. | اطلب مفتاحاً بالخدمة، أو سجّل النطاق. |
| 404 | مسار أو خدمة غير موجودة، أو الخريطة غير مفعّلة. | تحقق من العنوان. |
| 429 | TooManyRequests: تجاوز الحد في الدقيقة. QuotaExceeded: انتهت الحصة الشهرية. | انتظر عدد الثواني في Retry-After. لا تُعِد المحاولة في حلقة. |
| 502 / 504 | المحرك غير متاح أو بطيء، مثلاً أثناء تحديث البيانات (ثوانٍ). | أعِد المحاولة مرة بعد 1–2 ثانية، ثم اعرض خطأ. |
حدود الطلبات
لكل عميل ولكل عنوان IP للمستخدم (IPv6 حسب /64)، في نافذة متحركة مدتها دقيقة. يمكن رفعها لعميلك.
| الخدمة | في الدقيقة |
|---|---|
| البحث · العنوان | 60 · 60 |
| المسار · المصفوفة · الترتيب | 30 · 30 · 30 |
| أقرب طريق | 60 |
| إرسال مسارات GPS | 60 |
| روابط Google | 20 |
| الخريطة (tiles والخطوط) | 1200 |
الحصة الشهرية
- قد يكون لعميلك حد شهري لكل الخدمات معاً، لكل شهر ميلادي بتوقيت UTC.
- الطلبات التي ترفضها البوابة (401 و403 و429) لا تُحسب.
- عند استنفادها: 429 بالرمز
QuotaExceeded، وRetry-Afterحتى بداية الشهر التالي. - الاستهلاك والحصة في بوابة العملاء.
حدود أخرى
- نص البحث حتى 200 حرف، و
limitحتى 20 للبحث و10 للعنوان. - المسار والترتيب 2–25 نقطة، والمصفوفة 2–100، وأقرب طريق نقطة واحدة وحتى 10 نتائج.
- مسارات GPS: 2–100 نقطة من آخر ساعة، الأقدم أولاً.