يتم تأمين منتجات Google Maps Platform من الاستخدام غير المصرح به عن طريق تقييد استدعاءات واجهة برمجة التطبيقات لتلك التي توفر بيانات اعتماد المصادقة المناسبة. تكون بيانات الاعتماد هذه في شكل مفتاح واجهة برمجة التطبيقات - وهي سلسلة أبجدية رقمية فريدة تربط حساب فواتير Google الخاص بك بمشروعك، ومع واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) المحددة

يوضح هذا الدليل كيفية إنشاء مفتاح API وتقييده واستخدامه لمنصة Google Maps Platform

## قبل ان تبدأ
قبل البدء في استخدام Maps Static API، تحتاج إلى مشروع به حساب فواتير وتمكين Maps Static API. لمعرفة المزيد، راجع الإعداد في Cloud Console

## إنشاء مفاتيح API
يعد مفتاح واجهة برمجة التطبيقات (API) معرفًا فريدًا يقوم بتوثيق الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح API واحد على الأقل مرتبط بمشروعك

لإنشاء مفتاح API:
 وحدة التحكم
-
اذهب الى
منصة خرائط جوجل >صفحة بيانات الاعتماد

انتقل إلى صفحة بيانات الاعتماد
-
على ال
في صفحة بيانات الاعتماد، انقر فوق إنشاء بيانات اعتماد >مفتاح API

ال
يعرض مربع حوار إنشاء مفتاح واجهة برمجة التطبيقات (API) مفتاح واجهة برمجة التطبيقات (API) الذي تم إنشاؤه حديثًا

-
انقر
يغلق

تم إدراج مفتاح API الجديد في ملف
صفحة بيانات الاعتماد ضمن مفاتيح API

(تذكر تقييد مفتاح API قبل استخدامه في الإنتاج.)
 سحابة SDK
إنشاء مفاتيح API لخدمات gcloud Alpha \ --project "المشروع"\ --اسم العرض "DISPLAY_NAME"اقرأ المزيد حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:
## تقييد مفاتيح API
توصي Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات الخاصة بك عن طريق قصر استخدامها على واجهات برمجة التطبيقات المطلوبة لتطبيقك فقط. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات (API) إلى إضافة الأمان إلى تطبيقك عن طريق حمايته من الطلبات غير المبررة. لمزيد من المعلومات، راجع أفضل ممارسات أمان واجهة برمجة التطبيقات

لتقييد مفتاح API:
 وحدة التحكم
-
اذهب الى
منصة خرائط جوجل >صفحة بيانات الاعتماد

انتقل إلى صفحة بيانات الاعتماد
- حدد مفتاح API الذي تريد وضع قيود عليه. تظهر صفحة خصائص مفتاح API

- تحت
القيود الرئيسية، قم بتعيين القيود التالية:
- قيود التطبيق:
- لقبول الطلبات من قائمة عناوين IP لخادم الويب التي تقدمها، حدد
عناوين IP (خوادم الويب، وظائف cron، وما إلى ذلك) من قائمة قيود التطبيق. حدد عنوان IPv4 أو IPv6 واحدًا أو شبكة فرعية باستخدام تدوين CIDR (على سبيل المثال 192.168.0.0/22). نظرًا لأن طلب خدمة الويب الخاص بخدمة الويب يتحقق من عنوان IP الخارجي ويقارنه مع قيود مفتاح واجهة برمجة التطبيقات (API)، استخدم عنوان IP العام للخادم

- انقر
تقييد المفتاح

- يختار
واجهة برمجة التطبيقات الثابتة للخرائط من القائمة المنسدلة لتحديد واجهات برمجة التطبيقات. إذا لم تكن Maps Static API مدرجة، فستحتاج إلى تمكينها. **يحفظ**

 سحابة SDK

قائمة المفاتيح الموجودة

قائمة مفاتيح واجهة برمجة تطبيقات خدمات gcloud --project ="مشروع"قم بمسح القيود الموجودة على المفتاح الموجود

تحديث مفاتيح واجهة برمجة تطبيقات خدمات gcloud alpha "المشاريع/
PROJECT/keys/ KEY_ID"\ --clear-restrictions
تعيين قيود جديدة على المفتاح الموجود

تحديث مفاتيح واجهة برمجة تطبيقات خدمات gcloud alpha "المشاريع/
PROJECT/keys/ KEY_ID"\ --api_target="static-maps-backend.googleapis.com"--allowed-ips="IP_ADDRESS"اقرأ المزيد حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:
## إضافة مفتاح API لطلبك
يجب عليك تضمين مفتاح API مع كل طلب API للخرائط الثابتة. في المثال التالي،
يستبدل
YOUR_API_KEY باستخدام مفتاح API الخاص بك

httpsmaps.googleapis.com/maps/api/staticmap?center=40.714%2c%20-73.998&zoom=12&size=400x400&key=YOUR_API_KEY
HTTPS مطلوب للطلبات التي تستخدم مفتاح API

## ماذا بعد
يجب أيضًا أن تستخدم طلبات Maps Static API التوقيع الرقمي.