ادغام Google Maps Platform در Google AI Studio (AIS) به توسعه‌دهندگان امکان می‌دهد به‌سرعت نمونه‌های اولیه برنامه‌های وب مبتنی بر هوش مصنوعی را بسازند و مستقر کنند که دارای نقشه‌های تعاملی، داده‌های مکان واقعی، و قابلیت‌های مسیریابی هستند.
با ادغام کلید نسخه نمایشی Maps، می‌توانید نمونه‌های اولیه هوش مصنوعی کاربردی و آگاه از مکان را مستقیماً در AI Studio تولید کنید، بدون اینکه نیازی به ایجاد حساب صورت‌حساب Google Cloud یا ترک محیط توسعه خود داشته باشید. اگر ازقبل از Google Cloud استفاده می‌کنید، می‌توانید پروژه صورت‌حساب‌شده‌ای را متصل کنید تا بدون محدودیت‌های سهمیه نسخه نمایشی روزانه به همه محصولات Google Maps Platform دسترسی داشته باشید، یا با «کلید نسخه نمایشی Maps» شروع کنید و وقتی آماده مقیاس‌بندی بودید پروژه‌ای را متصل کنید.
ویژگی‌های مهم
- آماده‌سازی بدون دردسر: «کلید نمایشی Maps» را مستقیماً در AI Studio دریافت کنید بدون اینکه لازم باشد کارت اعتباری وارد کنید یا در کنسول Google Cloud پیمایش کنید، چه در Google Cloud تازه‌وارد باشید و چه ازقبل پروژه Cloud داشته باشید.
- تشخیص خودکار قصد: AI Studio پیام‌واره‌های جغرافیایی-فضایی را شناسایی می‌کند (مانند جستجوی مکان‌های اطراف، نمایش نقشه‌های تعاملی، یا محاسبه مسیرها) و به‌طور خودکار توصیه‌ها و مهارت‌های Google Maps Platform را پیکربندی می‌کند.
- نمونه‌سازی فوری: اطلاعات کاربری نسخه نمایشی به‌طور خودکار در پشت صحنه ارائه می‌شود تا کد تولیدشده با هوش مصنوعی شما بلافاصله اجرا شود.
- مقیاس‌بندی یکپارچه: وقتی برنامه‌تان آماده مقیاس‌بندی است، حساب Cloud Billing را پیوند دهید یا پروژه Cloud صورت‌حساب‌شده موجود را متصل کنید تا محدودیت‌های سهمیه برداشته شود.
روش‌های شروع به کار
AI Studio اطلاعات کاربری «پلاتفرم Google Maps» را فراهم می‌کند و آن‌ها را به‌طور ایمن در تنظیمات اسرار برنامه‌تان ذخیره می‌کند. نحوه شروع به کار بستگی به این دارد که آیا در Google Cloud تازه‌وارد هستید یا نه:
- تازه با Google Cloud آشنا شده‌اید: AI Studio یک پروژه رایگان و یک کلید نمایشی Maps برای شروع کار شما ایجاد می‌کند.
- کاربران فعلی Google Cloud: می‌توانید نمونه‌سازی اولیه بدون هزینه را با «کلید نسخه نمایشی Maps» (با زیرمجموعه‌ای از میاناهای برنامه‌سازی کاربردی و محدودیت‌های سهمیه روزانه) انتخاب کنید یا با متصل کردن پروژه ابری صورت‌حساب‌شده موجود، به سهمیه‌های سطح تولید دسترسی کامل داشته باشید.
«کلیدهای نسخه نمایشی Maps» تحت کنترل شرایط خدمات پروژه نسخه نمایشی Maps است.
| ویژگی | کاربر جدید | کاربر فعلی (نمونه‌سازی رایگان) | کاربر موجود (اتصال پروژه Cloud صورت‌حساب‌شده) |
|---|---|---|---|
| نوع اعتبارنامه | کلید نسخه نمایشی Maps | کلید نسخه نمایشی Maps | کلید استاندارد میانای برنامه‌سازی کاربردی Google Cloud |
| تنظیم صورت‌حساب | به کارت اعتباری یا حساب صورت‌حساب Google Cloud نیاز نیست | به کارت اعتباری یا حساب صورت‌حساب Google Cloud نیاز نیست | به حساب Google Cloud Billing نیاز دارد |
| پوشش میانای برنامه‌سازی کاربردی |
همه میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» (به‌جز Route Optimization، Solar، و Nav Connect)، ازجمله:
|
میاناهای برنامه‌سازی کاربردی نمونه‌سازی که معمولاً استفاده می‌شوند (به ویژگی‌های پشتیبانی‌شده مراجعه کنید):
|
۱۰۰٪ از مجموعه میانای برنامه‌سازی کاربردی «پلاتفرم Google Maps» (شامل «بهینه‌سازی مسیر»، Solar، و Nav Connect) |
| حدود روزانه | ۱۰۰ فراخوانی در روز برای هر میانای برنامه‌سازی کاربردی | ۱۰۰ فراخوانی در روز برای هر میانای برنامه‌سازی کاربردی | سهمیه‌های استاندارد و استفاده رایگان ماهانه |
| محدودیت‌های کلیدی | مدیریت خودکارشده اطلاعات محرمانه در جریان | مدیریت خودکارشده اطلاعات محرمانه در جریان | محدودیت‌های ارجاع‌دهنده HTTP، نشانی IP، یا برنامه سفارشی |
| هدف استفاده | نمونه‌سازی نخستین، آزمایش، و برنامه‌های تحت وب AI Studio | نمونه‌سازی نخستین، آزمایش، و برنامه‌های تحت وب AI Studio | برنامه‌های وب و تلفن همراه تولیدی |
| مسیر تولید | حساب Cloud Billing را به پروژه پیوند دهید؛ کلیدتان همچنان کار می‌کند | متصل کردن پروژه Cloud صورت‌حساب‌شده در AI Studio | ازقبل آماده تولید است |
عیب‌یابی و سهمیه‌ها
کلیدهای نمایشی ارائه‌شده ازطریق AI Studio تحت محدودیت‌های درخواست روزانه طراحی‌شده برای جلسات توسعه تعاملی عمل می‌کنند. حد درخواست روزانه ۱۰۰ تماس در روز برای هر API است.
خطاهای «از حد سهمیه فراتر رفته‌اید»
اگر برنامه‌تان هنگام استفاده از «کلید نمایشی» خطای RESOURCE_EXHAUSTED یا فراتر رفتن از سهمیه دریافت می‌کند:
- بازنشانی روزانه: سهمیه‌های کلید نمایشی هر ۲۴ ساعت به‌طور خودکار بازنشانی می‌شود. می‌توانید آزمایش را پس‌از چرخه بازنشانی ازسر بگیرید.
- هم‌پوشانی سهمیه کلید استاندارد: اگر از کلید میانای برنامه‌سازی کاربردی استاندارد استفاده می‌کنید و با پیام خطای سهمیه مواجه می‌شوید که به محدودیت‌های محیط نمایشی اشاره می‌کند، حدود سهمیه پروژه‌تان را در صفحه سهمیه‌های کنسول Google Cloud بررسی کنید.
- ارتقا دادن برای حجم بالاتر: اگر نیازهای نمونه‌سازی شما از محدودیت‌های نمایشی روزانه فراتر می‌رود، به حساب استاندارد Google Cloud ارتقا دهید تا سهمیه‌های تولید کامل را باز کنید.
خطاهای دردسترس نبودن میانای برنامه‌سازی کاربردی
اگر کاربر فعلی Google Cloud هستید که با «کلید نسخه نمایشی Maps» نمونه‌سازی اولیه می‌کنید و
درخواستی با خطای محدودیت کلید میانای برنامه‌سازی کاربردی ناموفق می‌شود (برای مثال،
ApiTargetBlockedMapError در Maps JavaScript API)، این میانای برنامه‌سازی کاربردی در
فهرست میاناهای برنامه‌سازی کاربردی پشتیبانی‌شده برای آن کلید نیست. برای استفاده از آن، پروژه Cloud صورت‌حساب‌شده‌ای را متصل کنید.
درحال ارتقا به کلید محصول
وقتی برنامه‌تان برای تولید آماده شد یا به محدودیت‌های سهمیه بالاتری نیاز داشت، حساب Cloud Billing را در کنسول Google Cloud پیوند دهید تا پروژه‌تان را ارتقا دهید. کلید میانای برنامه‌سازی کاربردی نمایشی موجودتان همچنان کار می‌کند، بنابراین نیازی به به‌روزرسانی کد برنامه‌تان نیست.
اگر ازقبل حساب صورت‌حساب Cloud دارید، می‌توانید از «کلید نسخه نمایشی» هم رد شوید: وقتی Google Maps Platform را در AI Studio فعال می‌کنید، یکی از پروژه‌های Cloud صورت‌حساب‌شده‌تان را انتخاب کنید تا کلید میانای برنامه‌سازی کاربردی استانداردی با پوشش کامل میانای برنامه‌سازی کاربردی و سهمیه‌های استاندارد از ابتدا دریافت کنید.
منابع مرتبط
- دریافت و استفاده از «کلید نسخه نمایشی Maps»
- مهارت‌های عامل پلاتفرم Google Maps
- Maps Grounding Lite (MCP)
- Google Maps Platform Code Assist