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

این سند مراحل لازم برای شروع استفاده از «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» را شرح می‌دهد.

پیش‌نیازها

این رویه شما را در راه‌اندازی کردن «حساب Google Cloud» و پروژه Google Cloud با صورت‌حساب فعال راهنمایی می‌کند. همچنین باید با نحوه کسر هزینه برای استفاده از «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» آشنا باشید.

1. مرور صورت‌حساب و هزینه استفاده در کیت توسعه نرم‌افزار Places برای استفاده و صورت‌حساب Android.

2. تأیید کنید که حساب Google Cloud دارید.

   به سیستم کنسول Google Cloud وارد شوید
   توجه: اگر کاربر جدید هستید و «حساب Google Cloud» ندارید، یعنی نمی‌توانید به سیستم کنسول وارد شوید، شروع به کار با Google Maps Platform را ببینید.

3. تأیید کنید که پروژه Google Cloud با صورت‌حساب فعال دارید.

   رفتن به صفحه «صورت‌حساب»
   توجه: اگر کاربر جدید هستید و پروژه Google Cloud ندارید، شروع به کار با Google Maps Platform را ببینید.
1. پروژه‌تان را انتخاب کنید تا صفحه صورت‌حساب باز شود.

2. در صفحه صورت‌حساب:

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

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

قبل‌از اینکه بتوانید از Places SDK for Android استفاده کنید، باید از کنسول Google Cloud یا فرمان gcloud برای فعال کردن آن در پروژه Google Cloud خود استفاده کنید.

توجه: بعداز فعال کردن کیت توسعه نرم‌افزار، ممکن است لازم باشد چند دقیقه صبر کنید تا بتوانید درخواستی به آن ارسال کنید.

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android به Places API (جدید) وابسته است. برای فعال کردن Places API (جدید):

کنسول

1. صفحه محصول را در کنسول Google Cloud باز کنید:

   فعال کردن Places API (جدید)

2. روی دکمه فعال کردن کلیک کنید.

   توجه: اگر Places API (New) ازقبل فعال شده باشد، دکمه مدیریت را به‌جای فعال کردن می‌بینید.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "places.googleapis.com"

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

• gcloud services enable
• gcloud services disable

پیکربندی کلید میانای API (کلید میانای برنامه‌سازی کاربردی)

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

دریافت کلید میانای برنامه‌سازی کاربردی برای استفاده با Places API (جدید)

کلید میانای برنامه‌سازی کاربردی رشته الفبانمایی منحصربه‌فردی است که حساب Cloud Billing و پروژه Google Cloud شما را با درخواستی که برنامه‌تان از میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار Google Maps Platform می‌کند مرتبط می‌کند. برای ایجاد کلید جدید یا افزودن میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار به کلید موجود، این دستورالعمل‌ها را دنبال کنید.

کنسول

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

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

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

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

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

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

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

     1. روی نام کلید کلیک کنید.
     2. در فهرست انتخاب محدودیت‌های میانای برنامه‌سازی کاربردی، میانای برنامه‌سازی کاربردی Places (جدید) را انتخاب کنید.
     3. روی ذخیره کلیک کنید.

   انتخاب کردن میانای برنامه‌سازی کاربردی در اینجا آن را فعال نمی‌کند. مطمئن شوید Places API (New) در صفحه کتابخانه API آن فعال باشد.

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

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

gcloud

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

• ایجاد کلید جدید: فرمان زیر را اجرا کنید و DISPLAY_NAME را با نامی برای کلید جایگزین کنید.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=places.googleapis.com

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

  • gcloud services api-keys create

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

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=places.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  شناسه کلید، رشته کلید یا نام نمایشی نیست. برای پیدا کردن آن، 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 Maps»، ازجمله Places API (جدید)، استفاده کرد. شما مسئولیت مالی هزینه‌های ناشی از سوءاستفاده از کلیدهای میانای API نامحدود را برعهده دارید.

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

• محدودیت‌های میانای برنامه‌سازی کاربردی مشخص می‌کند کدام کیت‌های توسعه نرم‌افزار و میاناهای برنامه‌سازی کاربردی را می‌توان بااستفاده از کلید میانای برنامه‌سازی کاربردی فراخوانی کرد. کنسول و gcloud CLI هنگام ایجاد کلید به حداقل یک محدودیت API نیاز دارند.
• محدودیت‌های برنامه مشخص می‌کند کدام وب‌سایت‌ها، نشانی‌های IP، یا برنامه‌ها می‌توانند از کلید میانای برنامه‌سازی کاربردی استفاده کنند.

برای اطلاعات بیشتر درباره اعمال محدودیت‌ها، به محدود کردن کلیدهای میانای برنامه‌سازی کاربردی مراجعه کنید.

قدم بعدی چیست

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