تحديد المشاكل وحلّها

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الأخطاء

في حال حدوث خطأ، سيتم عرض نص استجابة عادي للتنسيق وسيتم ضبط رمز حالة HTTP على حالة خطأ.

تحتوي الإجابة على كائن واحد error يتضمن المفاتيح التالية:

  • code: هذه الحالة هي نفسها حالة HTTP للاستجابة.
  • message: وصف مختصر للخطأ
  • status: رمز حالة يشير إلى طبيعة الخطأ.

على سبيل المثال، سيؤدي إرسال مَعلمة placeId غير صالحة إلى عرض الخطأ التالي:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

وتتضمن الأخطاء المحتملة ما يلي:

الرمز الحالة الرسالة تحديد المشاكل وحلّها
400 INVALID_ARGUMENT المفتاح الذي قدّمته غير صالح. مفتاح واجهة برمجة التطبيقات غير صالح أو لم يتم تضمينه في الطلب. يُرجى التأكد من تضمين المفتاح بأكمله، وتفعيل واجهة برمجة التطبيقات لهذا المفتاح.
400 INVALID_ARGUMENT تحتوي معلمة "\"المسار\" على قيمة غير صالحة: ☃" يحتوي طلبك على وسيطات غير صالحة. في ما يلي الأسباب الأكثر احتمالاً لحدوث هذا الخطأ:
  • حدثت مشكلة في المعلمة path.
    يُرجى التأكّد من حصولك على نقطة واحدة على الأقل وأقل من 100 نقطة. يجب أن تكون كل نقطة زوجًا من الأرقام مفصولة بفاصلة، مثل: 48.409114,-123.369158. ويجب فصل النقاط باستخدام خط: '|'.
  • تضمّن طلبك placeId غير صالح.
  • يضمّ طلبك placeId وpath. ويمكن تحديد معلَمة واحدة فقط من هذه المعلّمات لكل طلب.

لن يتم عرض هذا الخطأ إذا تم ضبط placeId على طريق لم يعد موجودًا، أو مكان لم يكن طريقًا.

403 PERMISSION_DENIED تم حظر الطلب غير المسجّل. يُرجى الاشتراك باستخدام Google Developers Console. تم رفض الطلب لسبب واحد أو أكثر من الأسباب التالية:
  • مفتاح واجهة برمجة التطبيقات مفقود أو غير صالح.
  • لم يتم تفعيل الفوترة في حسابك.
  • تم تجاوز الحد الأقصى للاستخدام المفروض على الجهاز.
  • لم تعد طريقة الدفع المقدَّمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).

لاستخدام منتجات "منصة خرائط Google"، يجب تفعيل الفوترة في حسابك، ويجب أن تتضمّن جميع الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. لحلّ هذه المشكلة، اتّبِع الخطوات التالية:

404 NOT_FOUND يجب توفّر HTTPS لهذه الخدمة. تأكَّد من إرسال الطلبات إلى https://roads.googleapis.com/ وليس إلى http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED تمّ تقييد الطلب بسبب بلوغ الحدّ الأقصى المسموح به لطلبات المشروع. تم تجاوز حد الطلبات الذي أعددته في وحدة تحكم Google Cloud Platform. عادةً ما يتم ضبط هذا الحدّ كطلبات في اليوم والطلبات لكل 100 ثانية والطلبات لكل 100 ثانية لكل مستخدم. ويجب ضبط هذا الحدّ لمنع مجموعة واحدة أو مجموعة صغيرة من المستخدمين من استنفاد حصتك اليومية، مع السماح في الوقت نفسه بالوصول لجميع المستخدمين بشكل معقول. يُرجى الاطّلاع على استخدام Cloud API لضبط هذه الحدود.

عودة أسية

عندما يتعذّر تنفيذ الطلبات، يجب التأكّد من إعادة محاولة إجراء الطلبات مع تقليل الأس. على سبيل المثال، إذا تعذّر الطلب مرة واحدة، يمكنك إعادة المحاولة بعد ثانية، إذا تعذّر المحاولة مرة أخرى، ثم إعادة المحاولة بعد ثانيتين، ثم أربع ثوانٍ، وما إلى ذلك. ويضمن ذلك عدم تسبب الطلبات المعطلة أو الأعطال الواسعة النطاق في ملء خوادم Google، لأن العديد من البرامج تحاول إعادة محاولة الطلبات بسرعة كبيرة.

الأسئلة الشائعة حول تحديد المشاكل وحلّها

مشاكل التنفيذ

بأي وتيرة يجب أن أستخدم موقعًا جغرافيًا لمركبتي؟
يُنصَح كل 1-10 ثوانٍ للحصول على نتائج عالية الجودة تتضمن طرقًا سريعة.
هل هناك حد أقصى لعدد النقاط التي يمكنني إرسالها لكل طلب بحث؟
نعم، يمكن أن يتضمّن طلب البحث 100 نقطة كحدّ أقصى.
ما هو مستوى الدقة الذي يجب استخدامه لتخزين أزواج خطوط الطول/العرض الخاصة بي؟
للتأكّد من أن المسارات الملتقطة تتبع الطرق بجميع مستويات التكبير أو التصغير، حتى في مستوى التكبير أو التصغير، يجب تخزين أزواج خطوط الطول/الطول التي تم التقاطها في 7 من الأماكن العشرية للدقة.
هل يمكنني استخدام الخطوط المتعددة المشفّرة لعرض المسارات التي تم التقاطها؟
يتم تحديد الخطوط المتعددة المشفّرة بدقة لخمسة خانات عشرية، ما يؤدي إلى حدوث خطأ بمسافة مترين تقريبًا. وبالتالي، لا تكون الخطوط المتعددة المشفّرة مناسبة إذا كنت تريد أن تتتبّع المسارات التي تم تخطّيها الطريق بمستويات تكبير عالية.

المشاكل الشائعة

لم يتم التقاط بعض النقاط، أو هناك فجوات في المسارات التي تم التقاطها. كيف يمكنني تصحيح ذلك؟
  • إذا كنت تريد أخذ عينات من نقاطك على فترات زمنية، احرص على أخذ عينات منها على فترات زمنية أقصر (كل 1-10 ثوانٍ). في حال استخدام فاصل زمني أطول (على سبيل المثال، 60 ثانية)، قد لا تتمكّن خوارزمية "المحاذاة إلى الطريق" من تحديد الطرق التي يتم نقلها بدقة كافية.
  • إذا كنت تنقر يدويًا على خريطة لإنشاء نقاط، فمن السهل جدًا إنشاء مسارات تتضمّن بضع نقاط أو نقاط متفرقة لا تتعامل خوارزمية المحاذاة معها بشكل جيد. تُحقّق خوارزمية محاذاة الصورة أداءً أفضل للنقاط القريبة من بعضها. يمكنك تجربة العرض التوضيحي لمحاذاة إلى الطرق أو استخدام أداة فحص الطرقات لاختبار مساراتك.
لماذا المسارات المتعرّجة متعرجة أو بعيدة قليلاً عن الطريق عند التكبير؟
  • هل تقتطع دقة أزواج خطوط الطول/العرض وخط الطول قبل عرضها؟ إن تخزين تخزين أزواج خطوط الطول/العرض على شكل خطوط دقيق يبلغ أقل من 7 نقاط عشرية يؤدي إلى حدوث أخطاء في الدقة عند عرض المسار المقرَّب على الخريطة.
  • هل تستخدم خطوطًا متعددة مشفّرة؟ خطوط متعددة مشفرة تقطع أزواج خطوط الطول/العرض إلى 5 أماكن عشرية، ما يؤدي إلى حدوث خطأ عدة أمتار، ما يؤدي إلى خطوط متعرجة أو بعيدة قليلاً عن الطريق عند مستويات التكبير العالية.

إذا لم يكن أيٌّ مما سبق واردًا، قد يكون تم تحديث مربعات الخرائط مؤخرًا، ما يجعلها غير متزامنة مع فهرس الطريق المستخدَم للانطباق. إذا كانت بضعة طلبات بحث فقط متأثرة بهذا التغيير، من المحتمل أن يكون ذلك هو السبب. وبما أنّه يتم تعديل "خرائط Google" بانتظام، قد يحدث ذلك في بعض الأحيان، ويمكن أن يحدث ذلك في أغلب الأحيان إذا كنت تطّلِع بانتظام على المسارات القديمة على الخريطة (على سبيل المثال، المسارات التي تم التقاطها قبل عدة أسابيع). للحصول على أفضل تمثيل بصري، يجب إعادة محاذاة المسارات القديمة مباشرةً قبل عرضها على الخريطة، وذلك للحد من التناقضات بين مربعات الخريطة وفهرس الطرق المُستخدَم للانطباق.

ما الذي قد يتسبب في عرض حد السرعة للطريق X بشكل غير صحيح؟
ثمة حدود للسرعة مصدرها العديد من المصادر التي تختلف من حيث الدقة والتغطية. إذا وجدت نمطًا، على سبيل المثال حدود السرعة لنوع معين من الطرق أو في منطقة معينة بشكل خاطئ، يُرجى اتخاذ الخطوات التالية لإعلامنا بذلك:
  1. افتح "خرائط Google" على كمبيوتر مكتبي أو تطبيق "خرائط Google" لنظام التشغيل Android.
  2. افتح القائمة الجانبية على يمين الصفحة.
  3. اختيار إرسال التعليقات ملاحظة: قد يُطلب منك تسجيل الدخول.
  4. اختَر تعديل الخريطة.
  5. اختَر جزء الطريق الذي تريد تعديله.
  6. اختر التالي.
  7. في الحقل "أخرى"، وضّح أن حد السرعة غير صحيح للطريق.
  8. انقر على إرسال.
يمكنك أيضًا الإبلاغ عن المشاكل الأخرى هنا (على سبيل المثال، إذا كانت الطريق تحتوي على اسم غير صحيح أو مرسومة بشكل غير صحيح أو مغلقة أو خاصة).
لماذا يقطع مساري المأخوذ الزوايا بدلاً من متابعة الطريق؟
لحلّ هذه المشكلة، يُرجى التحقّق ممّا يلي:
  • تأكّد من ضبط المَعلمة interpolate على true.
  • تحقق من أخذ عينات من نقاط البيانات الأصلية على فترات زمنية كافية (كل 1-10 ثوانٍ).
لماذا أحصل على العديد من أجزاء الطريق التي تم عرضها في المسار المحاذاة لطريق بدون تغييرات في حدود السرعة؟
عند ضبط المعلَمة interpolate على true، يعرض طلب البحث عن الطريق السريع خطًا متعدّدًا يتّبع الطريق حول الزوايا والمنحنيات والدوّارات. إذا كان هناك منحنيات للطريق، يتم عرض أجزاء متعددة من الطريق حتى إذا لم يتغير حد السرعة، وذلك لإنشاء خط متعدد يتبع هندسة الطريق بشكل وثيق.