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

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

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

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

شروع کنید

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

مرحله ۱

کنسول

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

مرحله ۲

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

توجه داشته باشید که برخی‌از ادغام‌ها نیازمند فعال کردن چندین API/کیت توسعه نرم‌افزار هستند. اگر مطمئن نیستید کدام «میاناهای برنامه‌سازی کاربردی» یا «کیت‌های توسعه نرم‌افزار» را فعال کنید، از Capabilities Explorer (کاوشگر قابلیت‌ها) استفاده کنید، یا به مستندات میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزار موردنظرتان مراجعه کنید.

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

کنسول

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

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

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

Cloud SDK

فرمان زیر همه «میاناهای برنامه کاربردی Maps»، «مسیرها»، و «مکان‌ها» را فعال می‌کند:

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 ، و دستورات زیر بیشتر بخوانید:

از این فرمان برای فعال کردن «میاناهای برنامه‌سازی کاربردی محیط» استفاده کنید:

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

مرحله ۳

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

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

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

کنسول

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

    به صفحه «اطلاعات اعتباری» بروید

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

Cloud SDK

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

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

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

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

مراحل بعدی

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