يتم تأمين منتجات "منصة خرائط Google" من الاستخدام غير المصرح به من خلال حصر طلبات البيانات من واجهة برمجة التطبيقات على التطبيقات التي تقدّم بيانات اعتماد مصادقة صحيحة. وتكون بيانات الاعتماد هذه في شكل مفتاح واجهة برمجة تطبيقات، وهو سلسلة أبجدية رقمية فريدة تربط حساب الفوترة في Google بمشروعك، وبواجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) المحدّدة.
يعرض هذا الدليل كيفية إنشاء مفتاح واجهة برمجة التطبيقات وتقييده واستخدامه في Google Maps Platform.
قبل البدء
قبل البدء في استخدام الأماكن، تحتاج إلى مشروع يحتوي على حساب فوترة و واجهة برمجة تطبيقات الأماكن ممكنة. لمزيد من المعلومات، يُرجى الاطِّلاع على الإعداد في Cloud Console.
إنشاء مفاتيح واجهة برمجة التطبيقات
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح واجهة برمجة تطبيقات:
وحدة التحكّم
-
انتقل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات الاعتماد > مفتاح واجهة برمجة التطبيقات.
يعرض مربع الحوار مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(تذكر تقييد واجهة برمجة التطبيقات قبل استخدامها في الإنتاج).
Cloud SDK
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
يمكنك الاطّلاع على مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:
تقييد مفاتيح واجهة برمجة التطبيقات
وتنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات من خلال قصر استخدامها على واجهات برمجة التطبيقات المطلوبة فقط لتطبيقك. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات إلى إضافة أمان إلى تطبيقك عن طريق حمايته من الطلبات غير المرغوب فيها. لمزيد من المعلومات، راجع أفضل ممارسات أمان واجهة برمجة التطبيقات.
لتقييد مفتاح واجهة برمجة تطبيقات:
وحدة التحكّم
-
انتقل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
- اختَر مفتاح واجهة برمجة التطبيقات الذي تريد ضبط قيود عليه. تظهر صفحة موقع مفتاح واجهة برمجة التطبيقات.
- ضِمن القيود الأساسية، اضبط القيود التالية:
- قيود التطبيق:
- لقبول الطلبات من قائمة عناوين IP التي تقدِّمها لخادم الويب، اختَر عناوين IP (خوادم الويب ووظائف cron وما إلى ذلك) من قائمة قيود التطبيقات. حدِّد عنوان IPv4 أو IPv6 واحدًا أو شبكة فرعية باستخدام تدوين نظام CIDR (مثل 192.168.0.0/22). استخدِم عنوان IP العام للخادم لأنّ طلب خدمة الويب يتحقّق من عنوان IP الخارجي ويقارنه بمفتاح واجهة برمجة التطبيقات.
- قيود واجهة برمجة التطبيقات:
- انقر على تقييد المفتاح.
- حدد واجهة برمجة تطبيقات الأماكن من القائمة المنسدلة تحديد واجهات برمجة التطبيقات. إذا لم تكن واجهة برمجة تطبيقات الأماكن مدرجة في القائمة، فسيلزمك تمكينها.
- لإتمام التغييرات، انقر على حفظ.
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="places-backend.googleapis.com"
--allowed-ips="IP_ADDRESS"
يمكنك الاطّلاع على مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:
إضافة مفتاح واجهة برمجة التطبيقات إلى طلبك
يجب عليك تضمين مفتاح واجهة برمجة تطبيقات مع كل طلب من واجهة برمجة تطبيقات الأماكن. في المثال التالي،
استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات.
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&types=restaurant&name=harbour&key=YOUR_API_KEY
ويجب استخدام HTTPS للطلبات التي تستخدم مفتاح واجهة برمجة تطبيقات.