این صفحه مراحل اصلی و لازم را برای شروع استفاده از هریک از میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار در Google Maps Platform شرح می‌دهد.
راه‌اندازی سریع
اگر هرگز از کنسول Google Cloud برای ایجاد حساب صورت‌حساب یا پروژه استفاده نکرده‌اید، روی دکمه شروع به کار کلیک کنید که به تجربه راه‌اندازی تعاملی در کنسول Cloud برای کاربران جدید پیوند می‌دهد:
شروع کنیدیا اینکه می‌توانید مراحل راه‌اندازی الزامی زیر را تکمیل کنید:
مرحله ۱: راه‌اندازی پروژه
کنسول
-
در کنسول Google Cloud، در صفحه انتخابگر پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد پروژه Cloud جدید شروع شود.
-
مطمئن شوید که صورت‌حساب برای پروژه Cloud شما فعال است. مطمئن شوید که صورت‌حساب برای پروژه‌تان فعال است.
Google Cloud دوره آزمایشی با هزینه ۰٫۰۰ دلار ارائه می‌دهد. دوره آزمایشی در پایان ۹۰ روز یا پس‌از اینکه حساب ۳۰۰ دلار هزینه جمع کرد، هرکدام زودتر باشد، منقضی می‌شود. هرزمان خواستید لغو کنید. برای اطلاعات بیشتر، اعتبارات حساب صورت‌حساب و صورت‌حساب را ببینید.
کیت توسعه نرم‌افزار Cloud
gcloud projects create "PROJECT"
درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:
مرحله ۲: فعال کردن میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزار
برای استفاده از Google Maps Platform، باید میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزاری را که قصد دارید با پروژه‌تان استفاده کنید فعال کنید.
توجه داشته باشید که برخی‌از ادغام‌ها مستلزم آن است که چندین میانای برنامه‌سازی کاربردی/ کیت توسعه نرم‌افزار را فعال کنید. اگر مطمئن نیستید کدام میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار را فعال کنید، از کاوشگر قابلیت‌ها استفاده کنید یا اسناد مربوط به میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزار موردنظرتان را بررسی کنید.
برای فعال کردن یک یا چند میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار:
کنسول
-
با رفتن به صفحه «کتابخانه Maps API» در کنسول Cloud، میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار Google Maps Platform را که می‌توانید فعال کنید ببینید:
به صفحه کتابخانه Maps API بروید
- روی 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 مرتبط با پروژه‌تان داشته باشید.
برای ایجاد کلید میانای API:
کنسول
-
به صفحه پلاتفرم Google Maps > اطلاعات کاربری بروید.
-
در صفحه اطلاعات کاربری، روی ایجاد اطلاعات کاربری > کلید میانای برنامه‌سازی کاربردی کلیک کنید.
کادر گفتگوی کلید میانای API ایجاد شد کلید میانای API جدیداً ایجادشده را نمایش می‌دهد. -
روی بستن کلیک کنید.
کلید میانای API جدید در صفحه اطلاعات کاربری در بخش کلیدهای میانای API فهرست شده است.
(به‌خاطر داشته باشید که قبل‌از استفاده از کلید میانای API در تولید، آن را محدود کنید.)
کیت توسعه نرم‌افزار Cloud
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 Platform (براساس محصول) و میاناهای برنامه‌سازی کاربردی Google Maps Platform (براساس پلاتفرم) فهرست شده‌اند.