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

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

هزینه ها

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

قبل از شروع

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

مرحله 1

کنسول

  1. در Google Cloud Console، در صفحه انتخاب پروژه، روی Create Project کلیک کنید تا ایجاد یک پروژه Cloud جدید شروع شود.

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

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

    Google Cloud یک شارژ آزمایشی 0.00 دلاری ارائه می دهد. دوره آزمایشی در پایان 90 روز یا پس از جمع‌آوری هزینه‌های 300 دلاری حساب، هر کدام که زودتر اتفاق بیفتد، منقضی می‌شود. هر زمان خواستید لغو کنید. پلتفرم نقشه های گوگل دارای اعتبار ماهیانه 200 دلاری است. برای اطلاعات بیشتر، اعتبارات حساب صورت‌حساب و صورت‌حساب را ببینید.

Cloud SDK

gcloud projects create "PROJECT"

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

مرحله 2

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

کنسول

Maps Embed API را فعال کنید

Cloud SDK

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

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

مرحله 3

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

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

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

کنسول

  1. به صفحه پلتفرم نقشه های گوگل > اعتبارنامه بروید.

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

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

Cloud SDK

gcloud alpha 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 تنظیم و ساختید.

تمیز کردن

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

  1. در Google Cloud Console، به صفحه مدیریت منابع بروید:

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

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

مراحل بعدی