رسائل الخطأ في واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قد تُصدر واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" رسالة خطأ أو تحذير عند حدوث خطأ. يشرح هذا الدليل كل رسالة خطأ، ويقدّم المزيد من التعليمات لحل الأخطاء.
الطلبات غير الصالحة
في حال تقديم طلب غير صالح، تعرض واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" رمز حالة HTTP 4xx ورسالة تصف المشكلة. في ما يلي أمثلة على شروط الخطأ هذه. ملاحظة: هذه ليست
قائمة كاملة بالأخطاء المحتملة. يُرجى التحقّق من رمز الخطأ والرسالة التي تعرضها واجهة برمجة التطبيقات للاطّلاع على تفاصيل حول مشاكل محدّدة.
مثال على حالة الخطأ
رمز الحالة
يتضمن الطلب معلمة غير صالحة أو معلمة مطلوبة
مفقودة. على سبيل المثال، لا تقع المَعلمة size ضمن
النطاق المتوقّع للقيم الرقمية أو غير متوفّرة في الطلب.
400 BAD REQUEST
مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح.
403 FORBIDDEN
الأخطاء التي تمنع عرض صورة "التجوّل الافتراضي"
إذا كان الطلب صالحًا ولكن حدث خطأ آخر يمنع عرض صورة "التجوّل الافتراضي"، تعرض واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" إما صورة نصية أو صورة خطأ بدلاً من صورة "التجوّل الافتراضي"، وذلك استنادًا إلى الخطأ. ومن الأمثلة على حالة الخطأ هذه عندما يتجاوز التطبيق حدود الاستخدام الخاصة به.
الشكل: تم عرض صورة خطأ بدلاً من صورة "التجوّل الافتراضي"
الأخطاء المتعلقة بمفاتيح واجهة برمجة التطبيقات والفوترة
في حال استخدام واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" بدون مفتاح واجهة برمجة التطبيقات، أو في حال عدم تفعيل الفوترة في حسابك، ستعرض الصفحة صورة خطأ بدلاً من صورة "التجوّل الافتراضي"، مع رابط يشير إلى نوع الخطأ. على سبيل المثال
"g.co/streetviewerror/key".
الأخطاء والحلول بدون مفتاح
استخدام واجهة برمجة التطبيقات الثابتة للتجوّل الافتراضي بدون مفتاح واجهة برمجة التطبيقات. لحلّ المشكلة، يجب إجراء ما يلي:
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains error messages returned by the Street View Static API and provides instructions for resolving them.\u003c/p\u003e\n"],["\u003cp\u003eInvalid requests result in a \u003ccode\u003e4xx\u003c/code\u003e status code with a descriptive message, such as errors related to parameters or invalid API keys.\u003c/p\u003e\n"],["\u003cp\u003eWhen a valid request cannot display a street view image due to issues like usage limits, either text or an error image is returned.\u003c/p\u003e\n"],["\u003cp\u003eUsing the API without a key or billing enabled leads to an error image with a link to further information and solutions.\u003c/p\u003e\n"]]],[],null,["# Error Messages in Street View Static API\n\nThe Street View Static API may issue an error or warning when something goes\nwrong. This guide explains each error message, and provides further\ninstructions for resolving errors.\n\nInvalid requests\n----------------\n\nIn the case of an invalid request, the Street View Static API returns\nan HTTP `4xx` status code and a message describing the\nproblem. Below are examples of such error conditions. Note: This is not\na complete list of the possible errors. Please check the actual error code\nand message returned by the API for details of specific problems.\n\n| Example of error condition | Status code |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|\n| The request includes an invalid parameter, or a required parameter is missing. For example, the `size` parameter is not within the expected range of numeric values, or is missing from the request. | `400 BAD REQUEST` |\n| The API key included in the request is invalid. | `403 FORBIDDEN` |\n\nErrors that prevent a street view image from being displayed\n------------------------------------------------------------\n\nIf the request is valid, but another error occurs that prevents the street view image from\nbeing displayed, the Street View Static API returns either text or an error\nimage instead of the street view image, depending on the error. An example of such an error\ncondition is when the application exceeds its\n[usage limits](/maps/documentation/streetview/usage-limits).\n\nFigure: An error image displayed instead of a street view image\n\n### Errors related to API keys and billing\n\nIf you use the Street View Static API without an API key, or if billing\nis not enabled on your account, the page displays an error image instead of a\nstreet view image, with a link indicating the type of error. For example\n\"g.co/streetviewerror/key\".\n\n| Keyless errors and solutions ||\n|---|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | You are using the Street View Static API without an API key. To resolve, you must: 1. [Get an API key](/maps/documentation/streetview/get-api-key#get-an-api-key) 2. [Enable billing](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) 3. [Sign your URL](/maps/documentation/streetview/get-api-key#digital-signature) |\n| | Your request is missing a digital signature (required). To resolve, [Sign your URL](/maps/documentation/streetview/get-api-key#digital-signature) |"]]
