راه اندازی سریع Maps Embed API

یک نقشه تعاملی یا پانورامای نمای خیابان را با یک درخواست HTTP ساده در صفحه وب خود قرار دهید - بدون نیاز به جاوا اسکریپت.

هزینه‌ها

تمام درخواست‌های Maps Embed API بدون هزینه و با استفاده نامحدود در دسترس هستند. با این حال، همه درخواست‌ها همچنان به یک کلید معتبر Google Cloud API نیاز دارند. برای اطلاعات بیشتر، به بخش «استفاده و صورتحساب» مراجعه کنید.

قبل از اینکه شروع کنی

برای ایجاد یک نقشه جاسازی‌شده در صفحه وب خود، مراحل راه‌اندازی مورد نیاز را با کلیک کردن روی زبانه‌های زیر انجام دهید:

مرحله ۱

کنسول

  1. در کنسول گوگل کلود، در صفحه انتخاب پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد یک پروژه ابری جدید آغاز شود.

    به صفحه انتخاب پروژه بروید

  2. مطمئن شوید که صورتحساب برای پروژه ابری شما فعال است. تأیید کنید که صورتحساب برای پروژه شما فعال است .

    گوگل کلود یک دوره آزمایشی با هزینه ۰.۰۰ دلار ارائه می‌دهد. این دوره آزمایشی در هر ۹۰ روز یا پس از اینکه حساب کاربری ۳۰۰ دلار هزینه دریافت کرده باشد، هر کدام که زودتر اتفاق بیفتد، منقضی می‌شود. هر زمان که خواستید می‌توانید آن را لغو کنید. برای اطلاعات بیشتر، به بخش «اعتبار حساب صورتحساب» و «صورتحساب» مراجعه کنید.

SDK ابری 

gcloud projects create "PROJECT"

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

مرحله ۲

برای استفاده از پلتفرم نقشه‌های گوگل، باید APIها یا SDKهایی را که قصد دارید در پروژه خود استفاده کنید، فعال کنید.

کنسول

فعال کردن API جاسازی نقشه‌ها

SDK ابری 

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

مرحله ۳

این مرحله فقط فرآیند ایجاد کلید API را طی می‌کند. اگر از کلید API خود در محیط عملیاتی استفاده می‌کنید، اکیداً توصیه می‌کنیم کلید API خود را محدود کنید. می‌توانید اطلاعات بیشتر را در صفحه «استفاده از کلیدهای API» مخصوص محصول بیابید.

کلید API یک شناسه منحصر به فرد است که درخواست‌های مرتبط با پروژه شما را برای اهداف استفاده و صدور صورتحساب تأیید می‌کند. شما باید حداقل یک کلید API مرتبط با پروژه خود داشته باشید.

برای ایجاد کلید API:

کنسول

  1. به صفحه Google Maps Platform > Credentials بروید.

    به صفحه اعتبارنامه‌ها بروید

  2. در صفحه اعتبارنامه‌ها ، روی ایجاد اعتبارنامه > کلید API کلیک کنید.
    کادر محاوره‌ای ایجاد کلید API، کلید API تازه ایجاد شده شما را نمایش می‌دهد.
  3. روی بستن کلیک کنید.
    کلید API جدید در صفحه اعتبارنامه‌ها ، زیر عنوان کلیدهای API، فهرست شده است.
    (به یاد داشته باشید که قبل از استفاده از کلید API در محیط عملیاتی، آن را محدود کنید .)

SDK ابری 

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

تولید یک iframe

روی گزینه‌های زیر کلیک کنید و یک مکان و کلید API اضافه کنید تا یک iframe برای صفحه وب شما ایجاد شود. برای پارامترها و گزینه‌های بیشتر، به جاسازی نقشه مراجعه کنید.

تست iframe شما

برای دیدن iframe خود در یک پنجره مرورگر HTML:

  1. ویرایشگر متن پیش‌فرض خود را باز کنید. شما باید ویرایشگرهای متنی مانند TextEdit یا Microsoft Windows Notepad را به طور پیش‌فرض روی دستگاه خود نصب کرده باشید.
  2. یک فایل HTML ایجاد کنید و نام آن را index.html بگذارید.

  3. کد زیر را به iframe که در بالا ایجاد کردید اضافه کنید:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. فایل HTML خود را index.html ذخیره کنید.

  5. فایل HTML را با کشیدن آن از دسکتاپ به مرورگر وب، در مرورگر بارگذاری کنید؛ روش دیگر، دوبار کلیک کردن روی فایل است که در اکثر سیستم عامل‌ها کار می‌کند.

تبریک! شما به تازگی یک نقشه را با استفاده از Maps Embed API راه‌اندازی و ساخته‌اید.

تمیز کردن

شما می‌توانید پروژه گوگل کلود خود را حذف کنید تا پرداخت هزینه برای تمام منابع مورد استفاده در آن پروژه متوقف شود.

  1. در کنسول گوگل کلود، به صفحه مدیریت منابع بروید:

    به صفحه مدیریت منابع بروید

  2. اگر پروژه‌ای که قصد حذف آن را دارید به یک سازمان متصل است، فهرست سازمان را در بالای صفحه انتخاب و باز کنید.
  3. در لیست پروژه‌ها، پروژه‌ای را که می‌خواهید حذف کنید انتخاب کنید و روی «حذف» کلیک کنید.
  4. در کادر محاوره‌ای، شناسه پروژه را تایپ کنید و برای حذف پروژه ، روی خاموش کردن کلیک کنید.

مراحل بعدی