با یک درخواست ساده HTTP، نقشه تعاملی یا پانورامای «نمای خیابان» را در صفحه وب خود قرار دهید—به جاوا اسکریپت سفارشی نیاز نیست.
هزینه‌ها
همه درخواست‌های Maps Embed API بدون هزینه و با استفاده نامحدود دردسترس است. بااین‌حال، همه درخواست‌ها همچنان به کلید Google Cloud API معتبر نیاز دارند. برای اطلاعات بیشتر، استفاده و صورت‌حساب را ببینید.
قبل‌از شروع
برای ایجاد نقشه جاسازی‌شده در صفحه وب، مراحل راه‌اندازی الزامی را با کلیک کردن روی برگه‌های زیر تکمیل کنید:
مرحله ۱
کنسول
-
در کنسول Google Cloud، در صفحه انتخابگر پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد پروژه جدید Cloud را شروع کنید.
-
مطمئن شوید که صورت‌حساب برای پروژه Cloud شما فعال است. تأیید کنید که صورت‌حساب برای پروژه شما فعال است.
Google Cloud دوره آزمایشی با کارمزد ۰٫۰۰ دلار ارائه می‌دهد. دوره آزمایشی در پایان ۹۰ روز یا پس‌از اینکه حساب ۳۰۰ دلار هزینه انباشته کند، هرکدام زودتر باشد، منقضی می‌شود. هرزمان بخواهید می‌توانید لغو کنید. برای اطلاعات بیشتر، به اعتبارات حساب صورت‌حساب و صورت‌حساب مراجعه کنید.
Cloud SDK
gcloud projects create "PROJECT"
درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و دستورات زیر بیشتر بخوانید:
مرحله ۲
برای استفاده از Google Maps Platform، باید میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزاری را که قصد دارید با پروژه‌تان استفاده کنید فعال کنید.
کنسول
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "maps-embed-backend.googleapis.com"
درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و دستورات زیر بیشتر بخوانید:
مرحله ۳
این مرحله فقط فرایند ایجاد «کلید میانای برنامه‌سازی کاربردی» را طی می‌کند. اگر از «کلید API» خود در تولید استفاده می‌کنید، اکیداً توصیه می‌کنیم «کلید API» خود را محدود کنید. می‌توانید اطلاعات بیشتری در صفحه استفاده از کلیدهای API مخصوص محصول پیدا کنید.
کلید API یک شناسه یکتا است که درخواست‌های مرتبط با پروژه شما را برای اهداف استفاده و صورت‌حساب تأیید می‌کند. باید حداقل یک کلید API مرتبط با پروژه خود داشته باشید.
برای ایجاد کلید API:
کنسول
-
به صفحه پلاتفرم Google Maps > اطلاعات اعتباری بروید.
-
در صفحه اطلاعات اعتباری، روی ایجاد اطلاعات اعتباری > کلید API کلیک کنید.
کادر گفتگوی کلید میانای API ایجاد شد کلید میانای API جدیداً ایجادشده شما را نمایش می‌دهد. -
روی بستن کلیک کنید.
کلید جدید API در صفحه اطلاعات اعتباری در بخش کلیدهای API فهرست شده است.
(به‌یاد داشته باشید که قبل‌از استفاده از کلید در دسته هدف تولید، میانای برنامه‌سازی کاربردی را محدود کنید.)
Cloud SDK
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و دستورات زیر بیشتر بخوانید:
درحال تولید iframe
روی گزینه‌های زیر کلیک کنید و مکان و کلید API را اضافه کنید تا یک iframe برای صفحه وب خود تولید کنید. برای پارامترها و گزینه‌های بیشتر، جاسازی نقشه را ببینید.
درحال آزمایش iframe
برای دیدن iframe در پنجره مرورگر HTML:
- ویرایشگر نوشتار پیش‌فرضتان را باز کنید. باید ویرایشگرهای نوشتاری مانند TextEdit یا Microsoft Windows Notepad به‌طور پیش‌فرض در دستگاهتان نصب شده باشد.
- فایل HTML ایجاد کنید و آن را
index.htmlنام‌گذاری کنید. کد زیر را با iframe که در بالا تولید کردید اضافه کنید:
<html> <!-- Replace this code comment with your iframe. --> </html>فایل HTML
index.htmlرا ذخیره کنید.فایل HTML را با کشیدن آن از میز کار به مرورگر وب بار کنید؛ یا در اکثر سیستم‌های عامل، با دوکلیک کردن روی فایل می‌توانید آن را باز کنید.
تبریک می‌گوییم! به‌تازگی نقشه‌ای را بااستفاده از Maps Embed API راه‌اندازی و ساخته‌اید.
درحال پاک‌سازی
می‌توانید پروژه Google Cloud خود را حذف کنید تا صورت‌حساب همه منابع استفاده‌شده در آن پروژه متوقف شود.
- در کنسول Google Cloud، به صفحه مدیریت منابع بروید:
- اگر پروژه‌ای که قصد دارید حذف کنید به سازمانی پیوست شده است، فهرست سازمان را در بالای صفحه انتخاب و ازهم باز کنید.
- در فهرست پروژه، پروژه‌ای را که می‌خواهید حذف کنید انتخاب کنید و روی حذف کلیک کنید.
- در چارگوش گفتگو، شناسه پروژه را تایپ کنید و روی خاموش کردن کلیک کنید تا پروژه حذف شود.
مراحل بعدی
با راه‌اندازی پروژه Google Cloud خود، توسعه با Maps Embed API را شروع کنید:
برای فهرست پارامترها و گزینه‌های اضافی که می‌توانید به iframe خود اضافه کنید:
پروژه Maps خود را با «میانای برنامه‌سازی کاربردی جاوا اسکریپت» گسترش دهید: