Errors

MapsNetworkError class

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

کلاس پایه برای مدیریت خطاهای شبکه در Maps.

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 را در 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 را در Fleet Engine شناسایی می‌کند.
FLEET_ENGINE_LIST_TASKS List Tasks API را در Fleet Engine شناسایی می‌کند.
FLEET_ENGINE_LIST_VEHICLES میانای برنامه‌سازی کاربردی List Vehicles را در Fleet Engine شناسایی می‌کند.
FLEET_ENGINE_SEARCH_TASKS Search Tasks API را در Fleet Engine شناسایی می‌کند.
GEOCODER_GEOCODE میانای برنامه‌سازی کاربردی زمین‌کدیابی را در «زمین‌کدیاب» شناسایی می‌کند.
MAPS_MAX_ZOOM MaximumZoomImageryService API را در Maps API شناسایی می‌کند.
PLACES_AUTOCOMPLETE «میانای برنامه‌سازی کاربردی تکمیل خودکار» را در «میانای برنامه‌سازی کاربردی مکان‌ها» شناسایی می‌کند.
PLACES_DETAILS میانای برنامه‌سازی کاربردی Details را در میانای برنامه‌سازی کاربردی Places شناسایی می‌کند.
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 را در 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، این خطا نشان‌دهنده مشکلی است که ممکن است درصورت تغییر وضعیت سیستم برطرف شود. برای مثال، اگر از سیستم فایل ۳۲ بیتی خواسته شود که در آفستی که در محدوده [0,2^32-1] نیست بخواند، INVALID_ARGUMENT تولید می‌کند، اما اگر از آن خواسته شود که از آفستی فراتر از اندازه فایل فعلی بخواند، OUT_OF_RANGE تولید می‌کند.
PERMISSION_DENIED فراخواننده اجازه اجرای عملیات مشخص‌شده را ندارد. این کد خطا به این معنی نیست که درخواست معتبر است یا نهاد درخواست‌شده وجود دارد یا سایر پیش‌شرط‌ها را برآورده می‌کند.
RESOURCE_EXHAUSTED برخی‌از منابع تمام شده است، شاید سهمیه هر کاربر، یا شاید کل سیستم فایل فاقد فضای کافی است.
UNAUTHENTICATED درخواست اعتبارنامه اصالت‌سنجی معتبری برای این عملیات ندارد.
UNAVAILABLE این سرویس درحال‌حاضر دردسترس نیست. این احتمالاً شرایطی گذرا است که می‌توان آن را با امتحان مجدد با عقب‌نشینی اصلاح کرد. توجه داشته باشید که امتحان مجدد عملیات غیرهم‌توان همیشه ایمن نیست.
UNIMPLEMENTED عملیات در این سرویس اجرا نشده است یا پشتیبانی/فعال نشده است.
UNKNOWN خطای ناشناس. برای مثال، این خطا ممکن است زمانی برگردانده شود که وضعیت دریافتی از فضای نشانی دیگر متعلق به فضای خطایی باشد که در این فضای نشانی شناخته‌شده نیست. همچنین خطاهایی که توسط میاناهای برنامه‌سازی کاربردی ایجاد می‌شوند و اطلاعات کافی درباره خطا ارائه نمی‌دهند ممکن است به این خطا تبدیل شوند.