إضافة مفتاح Google Maps API إلى World Flight

ما الذي يتناوله هذا الشرح؟

يربط هذا الشرح مشروع Google Maps Platform شخصيًا بمشهد الطيران حول العالم في FPVSIM. تنشئ مشروعًا سحابيًا مخصصًا، وتفعّل Map Tiles API، وتنشئ بيانات اعتماد مقيّدة، وتحفظها في FPVSIM، ثم تحمّل موقعًا من العالم الحقيقي للطيران الافتراضي بنظام FPV.

قبل أن تبدأ

• حساب Google يتيح الوصول إلى Google Cloud Console.
• صلاحية إنشاء مشروع وضبط Maps Platform واستكمال أي متطلبات حالية للفوترة أو التحقق من الحساب.
• الوصول إلى FPVSIM واتصال إنترنت مستقر لبث مربعات الخرائط.
• وقت لمراجعة أسعار Google وحصص الاستخدام والشروط الحالية؛ فقد تكون وحدة التحكم والسياسات تغيرت منذ تسجيل عام 2023.

إنشاء بيانات الاعتماد بأمان

1. إنشاء مشروع سحابي مخصص

   سجّل الدخول إلى Google Cloud Console وأنشئ مشروعًا مخصصًا لمربعات خرائط FPVSIM. يسهّل المشروع المخصص إدارة الاستخدام والقيود وإلغاء بيانات الاعتماد.

2. استكمال إعداد الحساب وفق المتطلبات الحالية

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

3. تفعيل Map Tiles API

   افتح مكتبة API وابحث عن Map Tiles API، ثم اخترها وفعّلها للمشروع الجديد.

4. إنشاء مفتاح API

   افتح بيانات الاعتماد (Credentials) وأنشئ مفتاح API جديدًا. تعامل مع قيمته كسرّ، رغم أن التكامل عبر المتصفح قد يرسلها من جانب العميل.

5. تقييد المفتاح

   اقصر المفتاح على Map Tiles API وطبّق أضيق قيد للتطبيق يتوافق مع استخدامك لـ FPVSIM. اسمح فقط بنطاقات المصدر أو التطبيقات المطلوبة، ولا تعِد استخدام المفتاح في مشروعات لا علاقة لها بهذا الاستخدام.

6. إضافة ضوابط للتكلفة

   راجع حصص الاستخدام واضبط تنبيهات الميزانية أو الاستخدام حيثما تتوفر. أعد فحص هذه الضوابط كلما غيّرت Google أسعار Maps Platform أو حدودها.

تحميل موقع من العالم في FPVSIM

1. فتح مشهد الطيران حول العالم

   شغّل FPVSIM واختر اللعب السريع (Quick Play)، ثم افتح مشهد Google Earth أو المشهد المبني على Google Maps الظاهر في نهاية قائمة المشاهد.

2. إدخال مفتاحك الخاص

   الصق بيانات الاعتماد التي أنشأتها في حقل مفتاح API واحفظها. لا تلصق مفتاحًا منسوخًا من هذا الشرح أو أي شرح علني آخر.

3. انتظار تحميل مربعات الخرائط

   يبدأ المشهد طلب مربعات الخرائط بعد حفظ بيانات الاعتماد. إذا بدأت الكاميرا تحت السطح، فأعد التحميل أو ادخل المشهد مجددًا كما في العرض.

4. اختيار موقع والطيران

   انتقل إلى الموقع الذي تريد استكشافه وابدأ الطيران. قد تظهر تفاصيل المربعات تدريجيًا، خصوصًا مع اتصال أبطأ.

نصائح للأمان وحل المشكلات

• إذا كُشف مفتاح في أي وقت، فألغِه في Google Cloud Console وأنشئ بديلًا، بدلًا من محاولة إخفاء القيمة القديمة لاحقًا.
• قد يشير عالم فارغ أو محمّل جزئيًا إلى أن API غير مفعّلة، أو أن القيود لا تطابق الطلب، أو أن حصة الاستخدام نفدت، أو أن الفوترة غير نشطة، أو أن الشبكة بطيئة.
• راجع استخدام المشروع بعد الجلسة لاكتشاف الطلبات غير المتوقعة مبكرًا.
• لا تُظهر القيمة الكاملة لبيانات الاعتماد في لقطات الشاشة أو رسائل الدعم.