استفاده از کلیدهای میانای برنامه‌سازی کاربردی با Distance Matrix API (قدیمی)

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

این راهنما نشان می‌دهد که چگونه کلید میانای برنامه‌سازی کاربردی خود را برای «پلاتفرم Google Maps» ایجاد، محدود، و استفاده کنید.

قبل‌از شروع

قبل‌از شروع استفاده از Distance Matrix API (قدیمی)، به پروژه‌ای با حساب صورت‌حساب و Distance Matrix API (قدیمی) فعال نیاز دارید. برای کسب اطلاعات بیشتر، به راه‌اندازی در کنسول Cloud مراجعه کنید.

ایجاد کلیدهای میانای برنامه‌سازی کاربردی

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

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

کنسول

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

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

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

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

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

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

• gcloud services api-keys create

محدود کردن کلیدهای میانای برنامه‌سازی کاربردی

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

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

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

کنسول

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

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

2. کلید میانای API (کلید میانای برنامه‌سازی کاربردی) را که می‌خواهید برای آن محدودیت تنظیم کنید انتخاب کنید. صفحه ویژگی کلید میانای API (کلید میانای برنامه‌سازی کاربردی) ظاهر می‌شود.
3. در بخش محدودیت‌های کلید، محدودیت‌های زیر را تنظیم کنید:
• محدودیت‌های برنامه:
1. برای پذیرفتن درخواست‌ها از فهرست نشانی‌های IP سرور وب که ارائه می‌دهید، نشانی‌های IP (سرورهای وب، cron jobs، و غیره) را از فهرست محدودیت‌های برنامه انتخاب کنید. یک یا چند نشانی IPv4 یا IPv6، یا زیرشبکه را بااستفاده از نماد CIDR مشخص کنید. نشانی‌های IP باید با نشانی منبعی که سرورهای «پلاتفرم Google Maps» مشاهده می‌کنند مطابقت داشته باشد. اگر از ترجمه نشانی شبکه (NAT) استفاده می‌کنید، این نشانی معمولاً با نشانی IP عمومی دستگاه شما مطابقت دارد.
• محدودیت‌های میانای برنامه‌سازی کاربردی:
1. روی محدود کردن کلید کلیک کنید.
2. Distance Matrix API (Legacy) را از منو کرکره‌ای انتخاب میاناهای برنامه‌سازی کاربردی انتخاب کنید. اگر Distance Matrix API (Legacy) در فهرست نیست، باید آن را فعال کنید.
4. برای نهایی کردن تغییرات، روی ذخیره کلیک کنید.
   

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

هشدار: اجرای فرمان gcloud alpha services api-keys update جایگزین هرگونه محدودیت موجود در کلید میانای API می‌شود. این گزینه محدودیت‌های جدیدی را که به فرمان ارسال شده است به محدودیت‌های موجود اضافه نمی‌کند.

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

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=distance-matrix-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

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

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

باید با هر درخواست Distance Matrix API (قدیمی)، یک کلید میانای API اضافه کنید. در مثال زیر، YOUR_API_KEY را با کلید میانای API خودتان جایگزین کنید:

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key=YOUR_API_KEY

برای درخواست‌هایی که از کلید میانای برنامه‌سازی کاربردی استفاده می‌کنند، باید از HTTPS استفاده کنید.

توجه: هنگام استفاده از خدمات وب، همه نویسه‌های خاص داخل پارامترها باید کدبندی نشانی وب شوند. نشانی‌های وب باید به‌درستی کدگذاری شوند تا معتبر باشند و برای همه سرویس‌های وب به ۲۰۴۸ نویسه محدود می‌شوند. هنگام ساختن نشانی‌های وب خود، به این محدودیت توجه داشته باشید. مرورگرها، پراکسی‌ها، و سرورهای مختلف ممکن است محدودیت‌های نویسه نشانی وب متفاوتی نیز داشته باشند.