عیب یابی

در اینجا چند نکته برای عیب‌یابی مشکلات رایج ارائه شده است.

چرا شعاع دقت بسیار بزرگ است؟

اگر پاسخ موقعیت جغرافیایی شما مقدار بسیار بالایی را در فیلد دقت نشان دهد، ممکن است سرویس بر اساس IP درخواستی، به جای نقاط WiFi یا دکل‌های سلولی، موقعیت جغرافیایی را تعیین کند. این نوع پاسخ‌ها می‌توانند در صورتی رخ دهند که سرویس هیچ دکل سلولی یا نقطه دسترسی را تشخیص ندهد.

برای تأیید اینکه سرویس نمی‌تواند موقعیت جغرافیایی نقاط دسترسی شما را تعیین کند، در درخواست خود considerIp را روی false تنظیم کنید. اگر پاسخ ۴۰۴ باشد، تأیید کرده‌اید که اشیاء wifiAccessPoints و cellTowers شما نمی‌توانند موقعیت جغرافیایی خود را تعیین کنند.

چگونه می‌توانم خطای پاسخ را عیب‌یابی کنم؟

اگر درخواست شما خطایی ایجاد کند، سیستم یک بدنه پاسخ خطا با فرمت استاندارد برمی‌گرداند و کد وضعیت HTTP را روی وضعیت خطا تنظیم می‌کند.

پاسخ خطا شامل یک شیء با یک شیء خطا با کلیدهای زیر است:

• code : این همان وضعیت HTTP پاسخ است.
• message : شرح مختصری از خطا.
• errors : فهرستی از خطاهای رخ داده. هر خطا شامل یک شناسه برای نوع خطا (دلیل) و یک توضیح کوتاه (پیام) است.

برای مثال، ارسال JSON نامعتبر خطای زیر را برمی‌گرداند:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "parseError",
    "message": "Parse Error",
   }
  ],
  "code": 400,
  "message": "Parse Error"
 }
}

جمع‌آوری اطلاعات آزمایش از دستگاه‌ها

برای آزمایش بیشتر، می‌توانید با استفاده از SDKها و APIهای زیر، اطلاعات را از دستگاه خود جمع‌آوری کنید:

• دستگاه‌های اندروید : به Places SDK برای اندروید و Android Location APIs بروید.

• دستگاه‌های iOS : به Places SDK برای iOS بروید.

شرح خطاها

در اینجا خطاهای احتمالی که ممکن است در توضیحات با آنها مواجه شوید، آورده شده است.

دلیل	دامنه	کد وضعیت HTTP	توضیحات
dailyLimitExceeded	usageLimits	۴۰۳	شما از حد مجاز روزانه خود فراتر رفته‌اید.
keyInvalid	usageLimits	۴۰۰	کلید API شما برای API موقعیت جغرافیایی معتبر نیست. حتماً کل کلید را وارد کنید و اینکه یا API را خریداری کرده‌اید یا صورتحساب را فعال کرده و API را فعال کرده‌اید تا سهمیه را بدون هزینه دریافت کنید.
userRateLimitExceeded	usageLimits	۴۰۳	شما از محدودیت درخواستی که در کنسول Google Cloud پیکربندی کرده‌اید، فراتر رفته‌اید. این محدودیت معمولاً به صورت درخواست در روز، درخواست در هر ۱۰۰ ثانیه و درخواست در هر ۱۰۰ ثانیه برای هر کاربر تنظیم می‌شود. شما باید محدودیت خود را طوری پیکربندی کنید که از تمام شدن سهمیه روزانه شما توسط یک یا چند گروه کوچک از کاربران جلوگیری شود، در حالی که همچنان دسترسی معقولی به همه کاربران داده شود. برای پیکربندی این محدودیت‌ها، به بخش «محدود کردن استفاده از API» مراجعه کنید.
notFound	geolocation	۴۰۴	درخواست معتبر بود، اما هیچ نتیجه‌ای برگردانده نشد.
parseError	global	۴۰۰	متن درخواست از نوع JSON معتبر نیست. برای جزئیات بیشتر در مورد هر فیلد، به بخش متن درخواست مراجعه کنید.