شروع سریع Maps Embed API

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

هزینه‌ها

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

قبل‌از شروع

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

مرحله ۱: راه‌اندازی پروژه

کنسول

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

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

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

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

کیت توسعه نرم‌افزار Cloud

gcloud projects create "PROJECT"

درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

مرحله ۲: فعال کردن میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزار

برای استفاده از Google Maps Platform، باید میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزاری را که قصد دارید با پروژه‌تان استفاده کنید فعال کنید.

کنسول

فعال کردن Maps Embed API

کیت توسعه نرم‌افزار Cloud

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

درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

مرحله ۳: دریافت کلید میانای برنامه‌سازی کاربردی

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

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

کنسول

  1. به صفحه پلاتفرم Google Maps > کلیدها و اطلاعات کاربری بروید.

    به صفحه «کلیدها و اعتبارنامه‌ها» بروید

  2. اگر درخواست شد، پروژه‌تان را انتخاب کنید.

  3. یکی از موارد زیر را انجام دهید:

    • ایجاد کلید جدید:

      1. روی ایجاد اطلاعات کاربری > کلید میانای API کلیک کنید.
      2. در پانل ایجاد کلید میانای API، فهرست انتخاب محدودیت‌های میانای API را باز کنید.
      3. هر میانای برنامه‌سازی کاربردی را که این کلید به آن نیاز ندارد پاک کنید و مطمئن شوید Maps Embed API انتخاب‌شده باقی بماند.
      4. روی ایجاد کردن کلیک کنید. پانل کلید میانای برنامه‌سازی کاربردی جدیدتان را نمایش می‌دهد.

    • استفاده از کلید موجود:

      1. روی نام کلید کلیک کنید.
      2. در فهرست انتخاب محدودیت‌های API، Maps Embed API را انتخاب کنید.
      3. روی ذخیره کلیک کنید.

    انتخاب کردن میانای برنامه‌سازی کاربردی در اینجا آن را فعال نمی‌کند. مطمئن شوید Maps Embed API در صفحه کتابخانه API آن فعال باشد.

  4. برای دیدن رشته کلید در آینده، به صفحه کلیدها و اطلاعات کاربری بروید و روی نمایش کلید برای کلید کلیک کنید.

اگر کنسول با این مراحل متفاوت است، ایجاد کلید میانای برنامه‌سازی کاربردی و افزودن محدودیت‌های کلید میانای برنامه‌سازی کاربردی را در اسناد Google Cloud ببینید.

کیت توسعه نرم‌افزار Cloud

در فرمان‌های زیر، PROJECT_ID را با شناسه پروژه‌تان جایگزین کنید.

  • ایجاد کلید جدید: فرمان زیر را اجرا کنید و DISPLAY_NAME را با نامی برای کلید جایگزین کنید. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=maps-embed-backend.googleapis.com

    درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

  • استفاده از کلید موجود: فرمان زیر را اجرا کنید و KEY_ID را با شناسه کلید جایگزین کنید. پرچم --append میاناهای برنامه‌سازی کاربردی را که کلید ازقبل مجاز کرده است حفظ می‌کند. بدون آن، فرمان جایگزین آن‌ها می‌شود.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=maps-embed-backend.googleapis.com

    درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

    شناسه کلید، رشته کلید یا نام نمایشی نیست. برای پیدا کردن آن، gcloud services api-keys list --project="PROJECT_ID" را اجرا کنید. شناسه بخش آخر فیلد name است: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

برای دیدن رشته کلید، gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" را اجرا کنید.

درحال تولید iframe

روی گزینه‌های زیر کلیک کنید و مکان و کلید میانای برنامه‌سازی کاربردی را اضافه کنید تا 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، به صفحه مدیریت منابع بروید:

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

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

مراحل بعدی