چک لیست قبل از راه اندازی

محل مدیریت Client ID خود در Google Cloud Console

عملکرد مدیریت شناسه مشتری طرح Premium در کنسول Cloud در پایین صفحه اعتبارنامه های پلتفرم نقشه های Google، در بخش شناسه مشتری موجود است.

ناحیه Client ID جدید در صفحه اعتبارنامه

کارهای بیشتر مدیریت شناسه مشتری، از جمله مجوز URL و مدیریت مخفی امضای شناسه مشتری، را می توان در صفحه شناسه مشتری جداگانه، با کلیک بر روی نماد ویرایش ویرایش سمت راست سمت راست بخش Client ID ، مشاهده کرد.

مهم: طرح ممتاز پلتفرم Google Maps دیگر برای ثبت نام یا مشتریان جدید در دسترس نیست.

اطمینان حاصل کنید که تیم شما به منابع لازم دسترسی دارد

از Google Cloud Console استفاده کنید

چرا مهم است : Google Cloud Console به شما امکان دسترسی به اطلاعاتی مانند گزارش‌های استفاده ، فیدهای خبری و منابع توسعه‌دهنده را می‌دهد. مهمتر از آن، کنسول Cloud به شما اجازه می دهد تا در صورت مواجه شدن با هر گونه مشکل فنی در حین توسعه یا راه اندازی ، موارد پشتیبانی را با تیم پشتیبانی پلتفرم Google Maps تشکیل دهید .

قبل از راه‌اندازی، دسترسی Cloud Console را برای همه برنامه‌نویسانی که مسئول نگهداری برنامه شما هستند فعال کنید. اگر با مشکلات فنی مواجه شدید، دسترسی به کنسول Cloud به اعضای تیم شما اجازه می‌دهد تا با پشتیبانی تماس بگیرند و همچنین به تیم پشتیبانی ما اجازه می‌دهد با ذینفعان مناسب در سازمان شما تماس بگیرند. برای مثال، اگر ما ترافیک غیرعادی یا رفتاری را شناسایی کنیم که ممکن است منجر به شکست برنامه شما شود، ممکن است تیم پشتیبانی نیاز داشته باشد با سازمان شما تماس بگیرد. اطمینان از اینکه ما می توانیم با توسعه دهندگان مناسب تماس بگیریم می تواند تفاوت بین قطعی غیرمنتظره و جلوگیری از قطعی باشد.

در گروه های ایمیل اعلان مشترک شوید

چرا مهم است : برای اطمینان از به‌روز ماندن از پیشرفت‌ها و تغییرات در Maps API، توصیه می‌کنیم در یک یا چند گروه ایمیل زیر مشترک شوید:

  • google-maps-platform-notifications - به‌روزرسانی‌های فنی درباره APIها و سرویس‌های وب پلتفرم Google Maps، اعلان‌های خاموشی و اعلان‌های ویژگی‌های پلتفرم (حدود 3 تا 5 پیام در ماه).
  • google-maps-js-api-v3-notify - نسخه های جدید Google Maps JavaScript API (~4 پیام در سال).

بهینه سازی اپلیکیشن شما

یک فایروال را پیکربندی کنید تا امکان دسترسی به خدمات پلتفرم Google Maps را فراهم کند

چرا مهم است : سرویس‌های پلتفرم نقشه‌های گوگل از دامنه‌های مختلفی استفاده می‌کنند که برخی از آنها به دامنه *google.com تعلق ندارند. اگر پشت یک فایروال محدود هستید، مهم است که اجازه دسترسی به دامنه های استفاده شده توسط هر سرویس Maps API را بدهید. اگر فایروال شما اجازه دسترسی به این دامنه ها را ندهد، درخواست های API با شکست مواجه می شوند که می تواند برنامه های شما را خراب کند. فهرست کامل دامنه‌های مورد استفاده توسط Maps API را ببینید.

ما مدیریت محدودیت های فایروال را با آدرس IP توصیه نمی کنیم، زیرا IP های مرتبط با این دامنه ها ثابت نیستند.

توجه: سرویس‌های پلتفرم نقشه‌های گوگل از پورت 80 (http) و 443 (https) برای ترافیک ورودی و خروجی استفاده می‌کنند. این خدمات همچنین به درخواست های GET، POST، PUT، DELETE و HEAD نیاز دارند. فایروال خود را به گونه ای پیکربندی کنید که ترافیک روی این پورت ها مجاز باشد و درخواست ها بسته به API و موارد استفاده مجاز باشد.

دامنه های SSL خود را برای استفاده با Maps JavaScript API مجاز کنید

چرا مهم است : هنگام استفاده از Maps JavaScript API با دامنه SSL، بسیار مهم است که به صراحت دامنه های HTTPS خود را مجاز کرده باشید تا مطمئن شوید درخواست های شما رد نمی شود. توجه داشته باشید که مجوز http://yourdomain.com به طور خودکار معادل SSL آن، https://yourdomain.com را فعال نمی کند. با اسکرول کردن به بخش Client ID ، فهرست دامنه های مجاز خود را در Cloud Console بررسی کنید. برای عیب یابی خطاهای مربوط به استفاده از API های سمت سرویس گیرنده با دامنه SSL، بررسی کنید که آیا عناصر صفحه شما از طریق HTTP بارگیری شده است. راهنمای عیب‌یابی مجوز را مشاهده کنید.

نسخه API مناسب را انتخاب کنید

چرا مهم است : قبل از توسعه برنامه خود، مهم است که بدانید کدام نسخه از API ها منسوخ شده اند. انتخاب توسعه در برابر نسخه‌های منسوخ نشده APIها باعث صرفه‌جویی در زمان توسعه شما می‌شود و پس از دردسترس نشدن نسخه‌های منسوخ شده، هزینه آن نیز کاهش می‌یابد.

به ویژه، درک طرح نسخه‌سازی مورد استفاده توسط Maps JavaScript API بسیار مهم است تا از استفاده تصادفی از نسخه نامناسب API در محیط خود جلوگیری کنید.

به عنوان مثال، ممکن است استفاده از نسخه آزمایشی API در محیط توسعه یا آزمایش شما مناسب باشد، اما ما به شدت از استفاده از نسخه آزمایشی در محیط تولید خودداری می کنیم. SLA ما فقط برای نسخه های پایدار API اعمال می شود، بنابراین باید فقط از نسخه های پایدار در محیط تولید خود استفاده کنید.

راهنمای نسخه‌های Maps JavaScript API را ببینید.

بین طراحی سمت مشتری و سمت سرور یکی را انتخاب کنید

چرا مهم است : انتخاب رویکرد سمت مشتری یا سمت سرور یک تصمیم معماری است و برای ثبات و مقیاس پذیری برنامه شما کاملاً حیاتی است. به طور کلی، یک رویکرد سمت سرور باید برای پردازش پیش و پس از پردازش سوابق آفلاین (یعنی خارج از برنامه شما) استفاده شود. روش دیگر، باید برای بخش‌هایی از برنامه‌های کاربردی که با کاربرانتان تعامل دارند، از رویکرد سمت کلاینت استفاده شود (یعنی، درخواست‌های ارسالی کاربر را در زمان واقعی پردازش کنید).

استقرار یک رویکرد سمت سرور که در آن باید رویکرد سمت سرویس گیرنده به جای آن استفاده شود، دلیل اصلی فراتر رفتن از سهمیه ها و در نتیجه، برنامه های کاربردی خراب است. ما به شدت توصیه می‌کنیم قبل از طراحی یا راه‌اندازی برنامه‌هایی که به تماس‌های سمت سرور متکی هستند، با استراتژی‌های کدگذاری جغرافیایی مشورت کنید.

استفاده از سهمیه را بهینه کنید

چرا مهم است : درک روشی که برنامه شما سهمیه مصرف می‌کند، که به عنوان اعتبارات Maps APIs شناخته می‌شود، به شما کمک می‌کند تا مبلغی را که پرداخت می‌کنید کاهش دهید. برای مثال، اگر از Maps JavaScript API استفاده می‌کنید، برنامه شما برای هر بار بارگیری نقشه ، اعتبار Maps APIs را مصرف می‌کند. راهنمای نرخ‌ها و محدودیت‌های استفاده از طرح Premium را ببینید.

مصرف سهمیه خدمات وب خود را مدیریت کنید

قبل از راه اندازی سرویس خود، بسیار مهم است که خطاهای مختلف مربوط به سهمیه (به عنوان مثال، OVER_QUERY_LIMIT ، User Rate Limit Exceeded ) را درک کنید و منطق مناسب را در برنامه خود تنظیم کنید تا بتوانید در صورت تجاوز از سهمیه خود به چنین خطاهایی پاسخ دهید. . لطفاً با خواندن سؤالات متداول محدودیت استفاده شروع کنید. برای کسب اطلاعات در مورد کدهای وضعیت بازگردانده شده توسط هر API، به راهنمای توسعه دهنده آن API مراجعه کنید. برای مثال، راهنمای کدهای وضعیت API Directions را ببینید. درک و پیاده‌سازی این مفاهیم احتمال فراتر رفتن از سهمیه مجاز برنامه شما، مسدود شدن توسط Google و/یا شکستن آن را تا حد زیادی کاهش می‌دهد.

تست بار را روی برنامه خود انجام دهید

چرا مهم است : از آزمایش بارگذاری برنامه خود استفاده کنید تا مطمئن شوید که می تواند حجم بالایی از درخواست ها را بدون فراتر از سهمیه های شما برای Maps API انجام دهد.

در حالی که پلتفرم نقشه‌های گوگل می‌تواند حجم ترافیک بسیار بالایی را مدیریت کند، آزمایش در برابر سرویس‌های زنده Google منجر به فراتر رفتن برنامه شما از سهمیه مجاز خود شده و احتمالاً توسط Google مسدود می‌شود. شما همچنین مسئول هزینه های استفاده از آزمایش بار هستید.

در عوض، آزمایش بارگذاری برنامه شما باید اطمینان حاصل کند که برنامه شما می‌تواند با حجم بالایی از درخواست‌ها بدون فراتر رفتن از سهمیه شما برای Maps API یا مسدود شدن توسط Google مقابله کند. برای رسیدن به این هدف، آزمایش بارگذاری را در برابر یک API ساختگی (جعلی) انجام دهید - سرویسی که می‌تواند حجم بالایی از درخواست‌ها را جذب کند - و بدون دخالت پلتفرم نقشه‌های گوگل، با پاسخ‌های معتبر به درخواست‌ها پاسخ دهید. به عنوان مثال: اگر سهمیه شما برای Geocoding API 20 QPS (پرس و جو در ثانیه) است، آزمایش بارگذاری برنامه شما باید اطمینان حاصل کند که برنامه شما می تواند 600 QPS را بدون ارسال بیش از 20 QPS به API Geocoding انجام دهد.

اگر قصد دارید آزمایش بارگذاری قابل توجهی انجام دهید، برای راهنمایی با پشتیبانی Google تماس بگیرید و مطمئن شوید که Google از آزمایش برنامه ریزی شده شما آگاه است.