محل مدیریت «شناسه کارخواه» در کنسول Google Cloud
عملکرد مدیریت «شناسه مشتری» Premium Plan در کنسول Cloud در پایین صفحه «اطلاعات اعتباری» Google Maps Platform، در بخش شناسه مشتری دردسترس است.
سایر کارهای مدیریت شناسه کارخواه، ازجمله مجوز نشانی وب و مدیریت رمز امضای شناسه کارخواه، در صفحه شناسه کارخواه جداگانه با کلیک کردن روی نماد ویرایش در سمت راست بخش شناسه کارخواه قابل‌دسترسی است.
مهم: «طرح Google Maps Platform Premium» دیگر برای ثبت‌نام یا مشتریان جدید دردسترس نیست.
اطمینان از اینکه تیم شما به منابع لازم دسترسی دارد
استفاده از کنسول Google Cloud
چرا مهم است: کنسول Google Cloud به شما امکان می‌دهد به اطلاعاتی مثل گزارش‌های استفاده، فیدهای اخبار، و منابع توسعه‌دهنده دسترسی داشته باشید. مهم‌تر اینکه، کنسول Cloud به شما امکان می‌دهد اگر درطول توسعه یا راه‌اندازی با مشکل فنی مواجه شدید، پرونده‌های پشتیبانی را با تیم پشتیبانی Google Maps Platform ثبت کنید.
قبل‌از راه‌اندازی، دسترسی به کنسول Cloud را برای همه توسعه‌دهندگانی که مسئول نگهداری برنامه‌تان هستند فعال کنید. اگر با مشکلات فنی مواجه شدید، دسترسی به کنسول Cloud به اعضای تیمتان اجازه می‌دهد با پشتیبانی تماس بگیرند و همچنین به تیم پشتیبانی ما اجازه می‌دهد با ذینفعان مناسب در سازمانتان تماس بگیرند. برای مثال، اگر ترافیک یا رفتار غیرعادی‌ای شناسایی کنیم که ممکن است درنهایت باعث خرابی برنامه‌تان شود، ممکن است تیم پشتیبانی لازم باشد با سازمانتان تماس بگیرد. اطمینان از اینکه می‌توانیم با توسعه‌دهندگان مناسب تماس بگیریم می‌تواند تفاوت بین داشتن قطعی غیرمنتظره و جلوگیری از قطعی باشد.
مشترک شدن در گروه‌های ایمیل اعلان
چرا مهم است: برای اطمینان از اینکه از توسعه‌ها و تغییرات در سراسر Maps API مطلع می‌مانید، توصیه می‌کنیم در یک یا چند گروه ایمیل زیر مشترک شوید:
- google-maps-platform-notifications - به‌روزرسانی‌های فنی درباره میاناهای برنامه‌سازی کاربردی و سرویس‌های وب «پلاتفرم Google Maps»، اعلان‌های قطعی، و اعلامیه‌های ویژگی پلاتفرم (حدود ۳ تا ۵ پیام در ماه).
- google-maps-js-api-v3-notify - نسخه‌های جدید Google Maps JavaScript API (حدود ۴ پیام در سال).
درحال بهینه‌سازی برنامه
پیکربندی دیوار آتش برای اجازه دسترسی به سرویس‌های Google Maps Platform
چرا مهم است: سرویس‌های Google Maps Platform از دامنه‌های مختلفی استفاده می‌کنند که برخی‌از آن‌ها به دامنه *google.com تعلق ندارند. اگر پشت دیوار آتش محدودکننده هستید، مهم است که اجازه دسترسی به دامنه‌های مورداستفاده هر سرویس Maps API را بدهید. اگر دیوار آتش شما اجازه دسترسی به این دامنه‌ها را ندهد،
درخواست‌های API ناموفق خواهد بود و این امر می‌تواند برنامه‌هایتان را خراب کند. فهرست کامل دامنه‌های مورداستفاده Maps APIs را ببینید.
توصیه نمی‌کنیم محدودیت‌های دیوار آتش را براساس نشانی IP مدیریت کنید، زیرا IPهای مرتبط با این دامنه‌ها ثابت نیستند.
توجه: سرویس‌های Google Maps Platform از درگاه ۸۰ (http) و ۴۴۳ (https) برای ترافیک ورودی و خروجی استفاده می‌کنند. این سرویس‌ها همچنین به درخواست‌های GET، POST، PUT، DELETE، و HEAD نیاز دارند. دیوار آتش خود را پیکربندی کنید تا ترافیک ازطریق این درگاه‌ها مجاز شود و درخواست‌ها، بسته به API و مورد استفاده، مجاز شوند.
دامنه‌های SSL خود را برای استفاده با Maps JavaScript API مجاز کنید
چرا مهم است: هنگام استفاده از Maps JavaScript API
با دامنه SSL، بسیار مهم است که صریحاً
دامنه‌های HTTPS خود را مجاز کرده باشید
تا مطمئن شوید درخواست‌هایتان رد نمی‌شوند. توجه داشته باشید که مجاز کردن http://yourdomain.com به‌طور خودکار معادل SSL آن، https://yourdomain.com، را فعال نمی‌کند. فهرست دامنه‌های مجازتان را در کنسول Cloud با پیمایش به‌پایین تا بخش شناسه مشتری بررسی کنید. برای عیب‌یابی خطاهای مربوط به استفاده از میاناهای برنامه‌سازی کاربردی سمت کارخواه
با دامنه SSL، بررسی کنید که آیا عناصری از صفحه‌تان ازطریق HTTP بار می‌شود یا نه. راهنمای
عیب‌یابی مجوز را مشاهده کنید.
نسخه API مناسب را انتخاب کنید
چرا مهم است: قبل‌از توسعه برنامه‌تان، مهم است که بدانید کدام نسخه‌های API منسوخ شده‌اند. انتخاب توسعه براساس نسخه‌های منسوخ‌نشده APIها باعث صرفه‌جویی در زمان و هزینه توسعه در آینده می‌شود، زیرا نسخه‌های منسوخ‌شده دیگر دردسترس نخواهند بود.
به‌ویژه، درک طرح نسخه‌بندی مورداستفاده توسط Maps JavaScript API بسیار مهم است تا از استفاده تصادفی از نسخه نامناسب API در محیط خود جلوگیری کنید.
برای مثال، ممکن است استفاده از نسخه آزمایشی API در محیط توسعه یا آزمایش شما مناسب باشد، اما اکیداً توصیه می‌کنیم از نسخه آزمایشی در محیط تولید استفاده نکنید. «قرارداد سطح خدمات» ما فقط برای نسخه‌های پایدار میانای برنامه‌سازی کاربردی اعمال می‌شود، بنابراین فقط باید از نسخه‌های پایدار در محیط تولید خود استفاده کنید.
راهنمای نسخه‌های Maps JavaScript API را ببینید.
انتخاب بین طراحی سمت کارخواه و سمت سرور
چرا مهم است: انتخاب رویکرد سمت کارخواه یا سمت سرور یک تصمیم معماری است و برای پایداری و مقیاس‌پذیری برنامه شما کاملاً حیاتی است. به‌طور کلی، برای پیش‌پردازش و پس‌پردازش سوابق به‌صورت آفلاین (یعنی خارج از برنامه شما) باید از رویکرد سمت سرور استفاده شود. یا اینکه باید از رویکرد سمت کارخواه برای بخش‌هایی از برنامه‌هایتان که با کاربران تعامل دارند (یعنی درخواست‌های ارسال‌شده توسط کاربر را به‌طور هم‌زمان پردازش می‌کنند) استفاده شود.
استفاده از رویکرد سمت سرور در جایی که باید از رویکرد سمت کارخواه استفاده شود، دلیل اصلی فراتر رفتن از سهمیه‌ها و درنتیجه، خراب شدن برنامه‌ها است. توصیه می‌کنیم قبل‌از طراحی یا راه‌اندازی برنامه‌هایی که به فراخوانی‌های سمت سرور متکی هستند، حتماً با استراتژی‌های زمین‌کدیابی مشورت کنید.
بهینه‌سازی استفاده از سهمیه
چرا مهم است: درک نحوه مصرف سهمیه توسط برنامه شما، که به‌عنوان «اعتبارات Maps API» شناخته می‌شود، به شما کمک می‌کند مبلغی را که پرداخت می‌کنید کاهش دهید. برای مثال، اگر از Maps JavaScript API استفاده می‌کنید، برنامه‌تان برای هر بار کردن نقشه، «اعتبارات Maps API» مصرف می‌کند. راهنمای نرخ‌ها و حدود استفاده از «طرح Premium» را ببینید.
مدیریت استفاده از سهمیه سرویس‌های وب
قبل‌از راه‌اندازی سرویس، بسیار مهم است که
خطاهای مختلف مربوط به سهمیه را درک کنید
(برای مثال، OVER_QUERY_LIMIT، User Rate Limit
Exceeded)، و منطق مناسب را در برنامه‌تان تنظیم کنید تا بتوانید
هنگام فراتر رفتن از سهمیه به چنین خطاهایی پاسخ دهید. لطفاً ابتدا
پرسشگان حدود استفاده را بخوانید.
برای کسب اطلاعات درباره کدهای وضعیت برگردانده‌شده توسط هر میانای برنامه‌سازی کاربردی، به
راهنمای توسعه‌دهنده آن میانای برنامه‌سازی کاربردی مراجعه کنید. برای مثال، راهنمای
کدهای وضعیت Directions API (قدیمی) را ببینید.
درک و پیاده‌سازی این مفاهیم احتمال اینکه برنامه‌تان از سهمیه مجازش فراتر برود، توسط Google مسدود شود، و/یا خراب شود را به‌شدت کاهش می‌دهد.
انجام آزمایش بارگذاری در برنامه
چرا مهم است: از آزمایش بارگذاری برنامه‌تان استفاده کنید تا مطمئن شوید می‌تواند حجم بالای درخواست‌ها را بدون فراتر رفتن از سهمیه‌های شما برای Maps API مدیریت کند.
درحالی‌که «پلاتفرم Google Maps» می‌تواند حجم ترافیک بسیار بالایی را مدیریت کند، آزمایش دربرابر سرویس‌های زنده Google منجر به فراتر رفتن برنامه شما از سهمیه مجاز آن می‌شود و احتمالاً توسط Google مسدود خواهد شد. همچنین مسئول هزینه‌های استفاده ناشی از آزمایش بار هستید.
درعوض، آزمایش بارگذاری برنامه شما باید اطمینان حاصل کند که برنامه شما قادر است با حجم بالای درخواست‌ها بدون فراتر رفتن از سهمیه‌های شما برای Maps API یا مسدود شدن توسط Google مقابله کند. برای دستیابی ایمن به این هدف، آزمایش بار را دربرابر یک میانای برنامه‌سازی کاربردی ساختگی (جعلی) انجام دهید—سرویسی که می‌تواند حجم بالایی از درخواست‌ها را جذب کند—و به درخواست‌ها با پاسخ‌های معتبر، بدون دخالت Google Maps Platform، پاسخ دهد. مثال: اگر سهمیه شما برای Geocoding API ۳۰۰۰ پِردَ (پرس‌وجو در دقیقه) است، آزمایش بارگذاری برنامه‌تان باید اطمینان حاصل کند که برنامه‌تان می‌تواند حجم بسیار بالاتری را، مثلاً ۹۰۰۰۰ پِردَ، بدون ارسال بیش‌از ۳۰۰۰ پِردَ به Geocoding API مدیریت کند.
اگر قصد دارید آزمایش بارگذاری قابل‌توجهی انجام دهید، برای راهنمایی و اطمینان از اینکه Google از آزمایش برنامه‌ریزی‌شده شما مطلع است، با پشتیبانی Google تماس بگیرید.