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

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

شروع سریع

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

شروع کنید

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

مرحله ۱

کنسول

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

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

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

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

SDK ابری

gcloud projects create "PROJECT"

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

مرحله ۲

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

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

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

کنسول

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

    به صفحه کتابخانه API نقشه‌ها بروید

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

SDK ابری

دستور زیر تمام APIهای نقشه‌ها، مسیرها و مکان‌ها را فعال می‌کند:

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

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

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

مرحله ۳

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

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

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

کنسول

  1. به صفحه Google Maps Platform > Credentials بروید.

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

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

SDK ابری

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

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

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

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

مراحل بعدی

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