استخدام مفاتيح واجهة برمجة التطبيقات مع API للخرائط الثابتة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

يعرض هذا الدليل كيفية إنشاء مفتاح واجهة برمجة التطبيقات وتقييده واستخدامه في Google Maps Platform.

قبل البدء

قبل البدء في استخدام واجهة برمجة التطبيقات الثابتة للخرائط، تحتاج إلى مشروع يحتوي على حساب فوترة و API للخرائط الثابتة ممكّنة. لمزيد من المعلومات، يُرجى الاطِّلاع على الإعداد في Cloud Console.

إنشاء مفاتيح واجهة برمجة التطبيقات

مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.

لإنشاء مفتاح واجهة برمجة تطبيقات:

وحدة التحكّم

  1. انتقل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

    الانتقال إلى صفحة "بيانات الاعتماد"

  2. في صفحة بيانات الاعتماد، انقر على إنشاء بيانات الاعتماد > مفتاح واجهة برمجة التطبيقات.
    يعرض مربع الحوار مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا.
  3. انقر على إغلاق.
    يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
    (تذكر تقييد واجهة برمجة التطبيقات قبل استخدامها في الإنتاج).

Cloud SDK

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

يمكنك الاطّلاع على مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:

تقييد مفاتيح واجهة برمجة التطبيقات

وتنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات من خلال قصر استخدامها على واجهات برمجة التطبيقات المطلوبة فقط لتطبيقك. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات إلى إضافة أمان إلى تطبيقك عن طريق حمايته من الطلبات غير المرغوب فيها. لمزيد من المعلومات، راجع أفضل ممارسات أمان واجهة برمجة التطبيقات.

لتقييد مفتاح واجهة برمجة تطبيقات:

وحدة التحكّم

  1. انتقل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

    الانتقال إلى صفحة "بيانات الاعتماد"

  2. اختَر مفتاح واجهة برمجة التطبيقات الذي تريد ضبط قيود عليه. تظهر صفحة موقع مفتاح واجهة برمجة التطبيقات.
  3. ضِمن القيود الأساسية، اضبط القيود التالية:
    • قيود التطبيق:
      1. لقبول الطلبات من قائمة عناوين IP التي تقدِّمها لخادم الويب، اختَر عناوين IP (خوادم الويب ووظائف cron وما إلى ذلك) من قائمة قيود التطبيقات. حدِّد عنوان IPv4 أو IPv6 واحدًا أو شبكة فرعية باستخدام تدوين نظام CIDR (مثل 192.168.0.0/22). استخدِم عنوان IP العام للخادم لأنّ طلب خدمة الويب يفحص عنوان IP الخارجي ويفرض قيودًا على مفتاح واجهة برمجة التطبيقات.
    • قيود واجهة برمجة التطبيقات:
      1. انقر على تقييد المفتاح.
      2. حدد واجهة برمجة تطبيقات الخرائط الثابتة من القائمة المنسدلة تحديد واجهات برمجة التطبيقات. إذا كانت واجهة برمجة التطبيقات للخرائط الثابتة غير مدرجة، ستحتاج إلى تفعيلها.
  4. لإتمام التغييرات، انقر على حفظ.

Cloud SDK

اسرد المفاتيح الحالية.

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

يمكنك الاطّلاع على مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:

إضافة مفتاح واجهة برمجة التطبيقات إلى طلبك

يجب تضمين مفتاح واجهة برمجة التطبيقات مع كل طلب لواجهة برمجة التطبيقات الثابتة في "خرائط Google". في المثال التالي، استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات.

https://maps.googleapis.com/maps/api/staticmap?center=40.714%2c%20-73.998&zoom=12&size=400x400&key=YOUR_API_KEY

ويجب استخدام HTTPS للطلبات التي تستخدم مفتاح واجهة برمجة تطبيقات.

الخطوات التالية

يجب أن تستخدم طلبات واجهة برمجة التطبيقات الثابتة للخرائط التوقيع الرقمي أيضًا.