با استفاده از کلیدهای API

پلتفرم را انتخاب کنید: سرویس وب جاوا اسکریپت اندروید iOS

قبل از شروع

قبل از شروع استفاده از Places SDK برای Android، به پروژه ای با حساب صورتحساب و فعال بودن Places SDK برای Android نیاز دارید. برای کسب اطلاعات بیشتر، به راه‌اندازی در Cloud Console مراجعه کنید.

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

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

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

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

کنسول

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

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

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

Cloud SDK

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

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

• gcloud alpha services api-keys create

توجه: می‌توانید از همان کلید API برای Maps SDK برای Android و Places SDK برای برنامه‌های Android استفاده کنید.

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

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

هنگام محدود کردن یک کلید API در Cloud Console، محدودیت‌های برنامه بر هر API فعال شده تحت محدودیت‌های API لغو می‌شود. با ایجاد یک کلید API جداگانه برای هر برنامه، و برای هر پلتفرمی که آن برنامه در آن در دسترس است، بهترین شیوه ها را دنبال کنید.

وقتی کلید API خود را محدود می‌کنید، باید اثر انگشت گواهینامه SHA-1 کلید امضایی را که برای امضای برنامه استفاده شده است ارائه دهید. دو نوع گواهی وجود دارد:

• گواهی اشکال زدایی : فقط از این نوع گواهی با برنامه هایی که در حال آزمایش هستید و سایر کدهای غیر تولیدی استفاده کنید. سعی نکنید برنامه‌ای را منتشر کنید که با گواهی اشکال‌زدایی امضا شده است. ابزارهای Android SDK این گواهی را به طور خودکار هنگام اجرای یک ساخت اشکال‌زدایی تولید می‌کنند.
• گواهی انتشار : زمانی که آماده انتشار برنامه خود در فروشگاه برنامه هستید از این گواهی استفاده کنید. ابزارهای Android SDK این گواهی را زمانی که یک نسخه انتشار را اجرا می کنید تولید می کنند.

برای اطلاعات بیشتر در مورد امضای برنامه Android و گواهینامه ها، به راهنمای برنامه خود را امضا کنید.

برای دستورالعمل‌هایی درباره نحوه یافتن اثر انگشت گواهی امضای خود، به مراجع زیر مراجعه کنید:

• اگر از Play App Signing استفاده می کنید، به کار با ارائه دهندگان API مراجعه کنید.
• اگر کلید امضای خود را مدیریت می کنید، به امضای خودکار برنامه خود مراجعه کنید یا به دستورالعمل های محیط ساخت خود مراجعه کنید.

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

کنسول

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

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

2. کلید API را که می خواهید محدودیتی روی آن تنظیم کنید، انتخاب کنید. صفحه ویژگی کلید API ظاهر می شود.
3. در زیر کلید محدودیت‌ها ، محدودیت‌های زیر را تنظیم کنید:
• محدودیت های کاربردی:
1. برنامه های اندروید را انتخاب کنید.
2. روی + افزودن نام بسته و اثر انگشت کلیک کنید.
3. نام بسته و اثر انگشت گواهی SHA-1 خود را وارد کنید. به عنوان مثال:

   com.example.android.mapexample

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

• محدودیت های API:
1. روی Restrict key کلیک کنید.
2. از منوی کشویی Select APIs Places API یا Places API (جدید) را انتخاب کنید، اما نه هر دو. اگر Places API در لیست نیست، باید آن را فعال کنید .
   توجه: اگر از Places API و Places API (جدید) استفاده می کنید، توصیه می کنیم برای هر نسخه API یک کلید API جداگانه ایجاد کنید.
4. برای نهایی کردن تغییرات خود، روی ذخیره کلیک کنید.
   

Cloud SDK

Places SDK برای Android (جدید)

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

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

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

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

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

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="places.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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

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

مکان‌های SDK برای Android

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

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

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

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

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

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="places-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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

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

بعدش چی

اکنون که یک کلید API دارید، یک پروژه را همانطور که در Setup an Android Studio Project توضیح داده شده ایجاد و پیکربندی کنید.