شروع به کار با «پلاتفرم Google Maps»

این صفحه مراحل اصلی و لازم را برای شروع استفاده از هریک از میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار در Google Maps Platform شرح می‌دهد.

راه‌اندازی سریع

اگر هرگز از کنسول Google Cloud برای ایجاد حساب صورت‌حساب یا پروژه استفاده نکرده‌اید، روی دکمه شروع به کار کلیک کنید که به تجربه راه‌اندازی تعاملی در کنسول Cloud برای کاربران جدید پیوند می‌دهد:

شروع کنید

یا اینکه می‌توانید مراحل راه‌اندازی الزامی زیر را تکمیل کنید:

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

کنسول

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

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

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

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

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

gcloud projects create "PROJECT"

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

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

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

توجه داشته باشید که برخی‌از ادغام‌ها مستلزم آن است که چندین میانای برنامه‌سازی کاربردی/ کیت توسعه نرم‌افزار را فعال کنید. اگر مطمئن نیستید کدام میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار را فعال کنید، از کاوشگر قابلیت‌ها استفاده کنید یا اسناد مربوط به میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزار موردنظرتان را بررسی کنید.

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

کنسول

  1. با رفتن به صفحه «کتابخانه Maps API» در کنسول Cloud، میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار Google Maps Platform را که می‌توانید فعال کنید ببینید:

    به صفحه کتابخانه Maps API بروید

  2. روی API یا SDK که می‌خواهید فعال شود کلیک کنید.
    • اگر روی دکمه فعال کردن نوشته شده است، روی دکمه کلیک کنید تا API یا SDK فعال شود.
    • اگر دکمه مدیریت را نشان می‌دهد، میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار ازقبل فعال شده است و لازم نیست کار دیگری انجام دهید.
    • با کلیک کردن روی هرکدام از دکمه‌ها، داشبورد میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار نمایش داده می‌شود. (برای برداشتن API یا SDK از این پروژه، روی دکمه غیرفعال کردن کلیک کنید.)

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

فرمان زیر همه میاناهای برنامه‌سازی کاربردی Maps،‏ Routes، و Places را فعال می‌کند:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

از این فرمان برای فعال کردن Environment APIs استفاده کنید:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

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

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

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

کنسول

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ایجاد کلید جدید: فرمان زیر را اجرا کنید و DISPLAY_NAME را با نامی برای کلید جایگزین کنید. SERVICE_NAME را با نام سرویس میانای برنامه‌سازی کاربردی که قصد دارید استفاده کنید، مثلاً places.googleapis.com، جایگزین کنید. برای مجاز کردن میاناهای برنامه‌سازی کاربردی بیشتر، پرچم --api-target را تکرار کنید.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

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

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

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

    درباره کیت توسعه نرم‌افزار 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" را اجرا کنید.

اعتبارات حساب صورت‌حساب

  • اگر هرگز مشتری پولی Google Cloud،‏ Google Maps Platform، یا Firebase نبوده‌اید، و قبلاً هرگز برای «دوره آزمایشی رایگان Google Cloud» ثبت‌نام نکرده‌اید، واجدشرایط دوره آزمایشی رایگان و اعتبار خوشامدگویی ۳۰۰ دلاری هستید که می‌توانید آن را برای سرویس‌های Google Maps Platform هزینه کنید.
  • هر SKU «پلاتفرم Google Maps» مقدار مشخصی استفاده ماهانه رایگان ارائه می‌دهد که در فهرست قیمت‌گذاری نشان داده شده است و در صورت‌حساب «پلاتفرم Google Maps» شرح داده شده است.
  • Google همچنین برای برنامه‌های عمومی مانند سازمان‌های غیرانتفاعی، استارتاپ‌ها، پاسخ به بحران، رسانه‌های خبری، آموزش، و سازمان‌های حمل‌ونقل عمومی اعتبار ارائه می‌دهد.

مراحل بعدی

پس‌از راه‌اندازی، می‌توانید استفاده از کیت‌های توسعه نرم‌افزار و میاناهای برنامه‌سازی کاربردی Google Maps Platform را شروع کنید. برای کسب اطلاعات بیشتر، به راهنماهای «نمای کلی»، «توسعه‌دهنده»، و «شروع به کار» برای میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار موردنظرتان مراجعه کنید. میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار در اسناد Google Maps Platform (براساس محصول) و میاناهای برنامه‌سازی کاربردی Google Maps Platform (براساس پلاتفرم) فهرست شده‌اند.