Errors

فئة MapsNetworkError

google.maps.MapsNetworkError class
extends Error
library "core"

الصنف الأساسي لإدارة أخطاء الشبكة في "خرائط Google"

const {MapsNetworkError} = await google.maps.importLibrary("core");
code
يحدّد نوع الخطأ الذي تنتجه واجهة برمجة التطبيقات.
endpoint
تمثّل خدمة الشبكة التي عرضت الخطأ.

فئة MapsRequestError

google.maps.MapsRequestError class
extends MapsNetworkError
library "core"

يمثّل خطأ في الطلب من خدمة ويب (أي ما يعادل رمز 4xx في HTTP).

const {MapsRequestError} = await google.maps.importLibrary("core");
السمات المكتسَبة: code، endpoint

فئة MapsServerError

google.maps.MapsServerError class
extends MapsNetworkError
library "core"

يمثّل خطأ من جهة الخادم من خدمة ويب (أي ما يعادل رمز 5xx في HTTP).

const {MapsServerError} = await google.maps.importLibrary("core");
السمات المكتسَبة: code، endpoint

ثوابت MapsNetworkErrorEndpoint

google.maps.MapsNetworkErrorEndpoint ثوابت
مكتبة "core"

معرّفات نقاط نهاية واجهة برمجة التطبيقات التي تستخدمها مثيلات MapsNetworkError

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع MapsNetworkErrorEndpointString.

const {MapsNetworkErrorEndpoint} = await google.maps.importLibrary("core");
DIRECTIONS_ROUTE تحدّد هذه السمة واجهة برمجة التطبيقات Routes API ضمن Directions API.
DISTANCE_MATRIX يحدّد DistanceMatrix API.
ELEVATION_ALONG_PATH تحدّد هذه المَعلمة واجهة برمجة التطبيقات getElevationsAlongPath ضمن Elevation API.
ELEVATION_LOCATIONS تحدّد واجهة برمجة التطبيقات getElevationForLocations ضمن Elevation API.
FLEET_ENGINE_GET_DELIVERY_VEHICLE يحدّد واجهة برمجة التطبيقات Get DeliveryVehicle API ضمن Fleet Engine.
FLEET_ENGINE_GET_TRIP يحدّد Get Trip API ضمن Fleet Engine.
FLEET_ENGINE_GET_VEHICLE يحدّد Get Vehicle API ضمن Fleet Engine.
FLEET_ENGINE_LIST_DELIVERY_VEHICLES يحدّد واجهة برمجة التطبيقات List DeliveryVehicles API ضمن Fleet Engine.
FLEET_ENGINE_LIST_TASKS يحدّد واجهة برمجة التطبيقات List Tasks API ضمن Fleet Engine.
FLEET_ENGINE_LIST_VEHICLES يحدّد واجهة برمجة التطبيقات List Vehicles API ضمن Fleet Engine.
FLEET_ENGINE_SEARCH_TASKS يحدّد Search Tasks API ضمن Fleet Engine.
GEOCODER_GEOCODE يحدّد واجهة برمجة تطبيقات الترميز الجغرافي ضمن أداة الترميز الجغرافي.
MAPS_MAX_ZOOM تحدّد واجهة برمجة التطبيقات MaximumZoomImageryService ضمن Maps API.
PLACES_AUTOCOMPLETE تحدّد هذه المَعلمة واجهة برمجة التطبيقات Autocomplete API ضمن Places API.
PLACES_DETAILS يحدّد Details API ضمن Places API.
PLACES_FIND_PLACE_FROM_PHONE_NUMBER يحدّد واجهة برمجة التطبيقات findPlaceFromPhoneNumber ضمن Places API.
PLACES_FIND_PLACE_FROM_QUERY يحدّد واجهة برمجة التطبيقات findPlaceFromQuery ضمن Places API.
PLACES_GATEWAY يحدّد Gateway API ضمن Places API.
PLACES_GET_PLACE يحدّد Get Place API ضمن Places API.
PLACES_SEARCH_TEXT تحدّد هذه السمة واجهة Search Text API ضمن Places API.
STREETVIEW_GET_PANORAMA يحدّد طريقة getPanorama ضمن خدمة "التجوّل الافتراضي".

ثوابت RPCStatus

google.maps.RPCStatus ثوابت
مكتبة "core"

الحالة التي تعرضها خدمة ويب يُرجى الاطّلاع على https://grpc.github.io/grpc/core/md_doc_statuscodes.html.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع RPCStatusString.

const {RPCStatus} = await google.maps.importLibrary("core");
ABORTED تم إلغاء العملية، ويرجع ذلك عادةً إلى مشكلة في التزامن، مثل تعذُّر التحقّق من التسلسل أو إلغاء المعاملة.
ALREADY_EXISTS الكيان الذي حاول العميل إنشاءه (مثل ملف أو دليل) موجود حاليًا.
CANCELLED تم إلغاء العملية، عادةً من قِبل المتصل.
DATA_LOSS فقدان البيانات أو تلفها بشكل لا يمكن استرداده
DEADLINE_EXCEEDED انتهى الموعد النهائي قبل اكتمال العملية. بالنسبة إلى العمليات التي تغيّر حالة النظام، قد يظهر هذا الخطأ حتى إذا اكتملت العملية بنجاح. على سبيل المثال، قد يكون الردّ الناجح من الخادم قد تأخّر كثيرًا.
FAILED_PRECONDITION تم رفض العملية لأنّ النظام ليس في الحالة المطلوبة لتنفيذها.
INTERNAL أخطاء داخلية وهذا يعني أنّ بعض الثوابت التي يتوقعها النظام الأساسي قد تم كسرها. رمز الخطأ هذا محجوز للأخطاء الخطيرة.
INVALID_ARGUMENT حدّد العميل وسيطة غير صالحة. يُرجى العِلم أنّ هذا يختلف عن FAILED_PRECONDITION. تشير السمة INVALID_ARGUMENT إلى الوسيطات التي تسبب مشاكل بغض النظر عن حالة النظام (على سبيل المثال، اسم ملف غير صالح).
NOT_FOUND لم يتم العثور على بعض الكيانات المطلوبة (مثل الملف أو الدليل).
OK لا يشير إلى خطأ، بل يتم عرضه عند نجاح العملية.
OUT_OF_RANGE تمت محاولة تنفيذ العملية بعد النطاق الصالح. على سبيل المثال، البحث عن نهاية الملف أو قراءتها. على عكس INVALID_ARGUMENT، يشير هذا الخطأ إلى مشكلة قد يتم حلّها في حال تغيّرت حالة النظام. على سبيل المثال، سينشئ نظام الملفات الذي يتألف من 32 بت INVALID_ARGUMENT إذا طُلب منه القراءة عند إزاحة ليست في النطاق [0,2^32-1]، ولكنه سينشئ OUT_OF_RANGE إذا طُلب منه القراءة من إزاحة تتجاوز حجم الملف الحالي.
PERMISSION_DENIED لا يملك المتصل الإذن لتنفيذ العملية المحدّدة. لا يعني رمز الخطأ هذا أنّ الطلب صالح أو أنّ الكيان المطلوب متوفّر أو يستوفي شروطًا مسبقة أخرى.
RESOURCE_EXHAUSTED تم استنفاد بعض الموارد، ربما حصة لكل مستخدم، أو ربما نفدت مساحة نظام الملفات بالكامل.
UNAUTHENTICATED لا يتضمّن الطلب بيانات اعتماد مصادقة صالحة للعملية.
UNAVAILABLE هذه الخدمة غير متاحة حاليًا. على الأرجح أنّ هذه حالة عابرة يمكن تصحيحها من خلال إعادة المحاولة مع استخدام فترة انتظار. يُرجى العِلم أنّه ليس من الآمن دائمًا إعادة محاولة تنفيذ العمليات غير المتكررة.
UNIMPLEMENTED لم يتم تنفيذ العملية أو أنّها غير متاحة/مفعَّلة في هذه الخدمة.
UNKNOWN حدث خطأ غير معروف. على سبيل المثال، قد يظهر هذا الخطأ عندما تنتمي حالة تم تلقّيها من مساحة عنوان أخرى إلى مساحة خطأ غير معروفة في مساحة العنوان هذه. وقد يتم تحويل الأخطاء التي تظهر من خلال واجهات برمجة التطبيقات التي لا تعرض معلومات كافية عن الخطأ إلى هذا الخطأ.