دریافت کلید API

پلتفرم را انتخاب کنید: Android iOS JavaScript

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

ایجاد کلیدهای API

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

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

کنسول

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

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

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

Cloud SDK 

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

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

هنگامی که پروژه Xcode خود را همانطور که در تنظیم پروژه Xcode توضیح داده شده است، به این کلید API نیاز دارید.

محدود کردن کلیدهای API

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

برای محدود کردن یک کلید API:

کنسول

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

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

  2. کلید API را که می خواهید محدودیتی روی آن تنظیم کنید، انتخاب کنید. صفحه ویژگی کلید API ظاهر می شود.
  3. در زیر کلید محدودیت‌ها ، محدودیت‌های زیر را تنظیم کنید:
    • محدودیت های کاربردی:
      1. برنامه های iOS را انتخاب کنید.
      2. برای پذیرش درخواست‌های برنامه iOS با شناسه بسته‌ای که ارائه می‌کنید، شناسه بسته iOS مناسب را از فهرست انتخاب کنید.
    • محدودیت های API:
      1. روی Restrict key کلیک کنید.
      2. Maps SDK for iOS را از منوی کشویی Select APIs انتخاب کنید. اگر Maps SDK برای iOS در لیست نیست، باید آن را فعال کنید .
  4. برای نهایی کردن تغییرات خود، روی ذخیره کلیک کنید.

Cloud SDK

فهرست کلیدهای موجود

gcloud services api-keys list --project="PROJECT"

محدودیت های موجود در کلید موجود را پاک کنید.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

محدودیت های جدیدی را روی کلید موجود تنظیم کنید.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-ios-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

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

اکنون که کلید API خود را برای Maps SDK برای iOS دریافت کرده‌اید، آماده شروع کار هستید.

بعدش چی

اکنون که یک کلید API دارید، پروژه Xcode خود را همانطور که در Set up an Xcode Project توضیح داده شده ایجاد و پیکربندی کنید.