شروع کار با پلتفرم نقشه های گوگل

این صفحه مراحل اولیه و ضروری را برای شروع استفاده از هر یک از APIها و SDKها در پلتفرم Google Maps طی می کند.

شروع سریع

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

شروع کنید

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

مرحله 1مرحله 2مرحله 3
کنسول Cloud SDK

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

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

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

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

gcloud projects create "PROJECT"

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

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

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

برای فعال کردن یک یا چند API یا SDK:

کنسول Cloud SDK

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

    به صفحه Maps API Library بروید

  2. روی API یا SDK مورد نظر برای فعال کردن کلیک کنید.
    • اگر روی دکمه ENABLE نوشته شده است، روی دکمه برای فعال کردن API یا SDK کلیک کنید.
    • اگر روی دکمه MANAGE نوشته شده باشد، API یا SDK قبلاً فعال شده است و نیازی به انجام کار دیگری ندارید.
    • با کلیک بر روی هر یک از دکمه ها، داشبورد API یا SDK نمایش داده می شود. (برای حذف API یا SDK از این پروژه، دکمه DISABLE را کلیک کنید.)

دستور زیر همه API های Maps، Routes و Places را فعال می کند:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "tileaerialview.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 SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

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

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

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

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

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

کنسول Cloud SDK

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

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

  2. در صفحه اعتبارنامه‌ها ، روی ایجاد اعتبارنامه > کلید API کلیک کنید.
    گفتگوی ایجاد شده کلید API کلید API تازه ایجاد شده شما را نمایش می دهد.
  3. روی Close کلیک کنید.
    کلید API جدید در صفحه Credentials در زیر کلیدهای API فهرست شده است.
    (به یاد داشته باشید که کلید API را قبل از استفاده از آن در تولید محدود کنید .) 
gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

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

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

مراحل بعدی

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