معالجة أخطاء الطلبات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
تعرض واجهة برمجة التطبيقات Routes API رسائل خطأ كجزء من
الاستجابة لطلب طريقة. على سبيل المثال، إذا حذفت مفتاح واجهة برمجة التطبيقات من
الطلب، ستُرجع الطريقة ما يلي:
{
"error": {
"code": 403,
"message": "The request is missing a valid API key.",
"status": "PERMISSION_DENIED"
}
}
في حال حذف مَعلمة مطلوبة للنصّ، مثل origin، تعرِض الطريقة
القيمة التالية:
{
"error": {
"code": 400,
"message": "Origin and destination must be set.",
"status": "INVALID_ARGUMENT"
}
}
لمزيد من المعلومات عن الأخطاء ومعالجتها، اطّلِع على
الأخطاء.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-06-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Routes API provides error messages within its responses to indicate issues with the request.\u003c/p\u003e\n"],["\u003cp\u003eErrors are returned as JSON objects containing an \u003ccode\u003eerror\u003c/code\u003e field with details about the issue, such as a code, message, and status.\u003c/p\u003e\n"],["\u003cp\u003eMissing API keys result in a \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e error with a 403 code.\u003c/p\u003e\n"],["\u003cp\u003eOmitting required parameters like \u003ccode\u003eorigin\u003c/code\u003e leads to an \u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e error with a 400 code.\u003c/p\u003e\n"],["\u003cp\u003eFurther details on errors and their handling can be found in the Google Cloud API Design Guide on Errors.\u003c/p\u003e\n"]]],[],null,["# Handle request errors\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Routes API returns error messages as part of the\nresponse to a method call. For example, if you omit the API key from the\nrequest, the method returns: \n\n```json\n{\n \"error\": {\n \"code\": 403,\n \"message\": \"The request is missing a valid API key.\",\n \"status\": \"PERMISSION_DENIED\"\n }\n}\n```\n\nIf you omit a required body parameter, such as `origin`, the method\nreturns: \n\n```json\n{\n \"error\": {\n \"code\": 400,\n \"message\": \"Origin and destination must be set.\",\n \"status\": \"INVALID_ARGUMENT\"\n }\n}\n```\n\nFor more information on errors and error handling, see\n[Errors](https://cloud.google.com/apis/design/errors)."]]
