التعرّف على المواقع الجغرافية للمنتجات والموارد في مشروعك

المنتجات أو المراجع التي تتطلّب إعداد موقع جغرافي

تتطلّب العديد من المنتجات أو الموارد إعدادات الموقع الجغرافي.

المنتج الموقع الجغرافي التلقائي معلومات إضافية
Firebase AI Logic
  • بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، ويكون الموقع الجغرافي دائمًا عالميًا.
  • بالنسبة إلى Vertex AI Gemini API: إذا لم يتم ضبط الموقع الجغرافي، تكون المنطقة التلقائية هي us-central1.
هذا هو المكان الذي يمكنك فيه الوصول إلى النموذج.
Google Analytics ما مِن موقع جغرافي تلقائي
يجب تحديد هذا الموقع الجغرافي. 		هذا الموقع الجغرافي هو Analytics موقع إعداد التقارير2، الذي يمثّل بلد مؤسستك أو منطقتها. يحدّد Analytics موقع إعداد التقارير العملة المستخدَمة في إعداد تقارير الأرباح.
Firebase App Hosting ما مِن موقع جغرافي تلقائي
يجب ضبط هذا الموقع الجغرافي لكل نظام خلفي. 		هذا الموقع الجغرافي هو المكان الذي تنشئ فيه عملية نشر App Hosting كل موارد الخلفية.
يمكن أن يكون كل نظام خلفي في موقع جغرافي مختلف.
Firebase Data Connect ما مِن موقع جغرافي تلقائي
يجب ضبط الموقع الجغرافي لكل نسخة. 		يمكن أن تكون كل نسخة في موقع جغرافي مختلف.
Cloud Firestore 1 ما مِن موقع جغرافي تلقائي
يجب ضبط الموقع الجغرافي لكل نسخة. 		يمكن أن تكون كل نسخة في موقع جغرافي مختلف.
Firebase Realtime Database ما مِن موقع جغرافي تلقائي
يجب ضبط الموقع الجغرافي لكل نسخة. 		يمكن أن تكون كل نسخة في موقع جغرافي مختلف.
Cloud Storage for Firebase 1 ما مِن موقع جغرافي تلقائي
يجب ضبط الموقع الجغرافي لكل مجموعة بيانات. 		يمكن أن يكون كل حزمة في موقع مختلف.
Cloud Functions for Firebase 1 إذا لم يتم ضبط الموقع الجغرافي، ستكون المنطقة التلقائية هي us-central1. يمكن أن تكون كل دالة في موقع جغرافي مختلف.

1 استنادًا إلى الوقت الذي بدأت فيه استخدام هذه المنتجات في مشروعك، قد تكون هناك تبعيات متعلقة بالموقع الجغرافي بين هذه المنتجات. وقد يُشار إلى هذا التبعية باسم "الموقع الجغرافي لموارد Google Cloud التلقائية". مزيد من المعلومات عن هذه التبعية المتعلقة بالموقع الجغرافي

2 إنّ Analytics موقع إعداد التقارير لا يؤثّر في الأماكن التي قد تعالج فيها Google وتخزّن بيانات العملاء في Firebase.

ضبط موقع جغرافي لمنتج أو موارده

بالنسبة إلى بعض المنتجات، يمكنك ضبط الموقع الجغرافي على مستوى المنتج. ومع ذلك، بالنسبة إلى معظم المنتجات، يمكنك ضبط الموقع الجغرافي على مستوى المورد (على سبيل المثال، لكل حزمة Cloud Storage أو لكل دالة).

المنتج الوقت المناسب لتحديد الموقع الجغرافي وكيفية إجراء ذلك المواقع الجغرافية التي تتوفّر فيها الميزة
Firebase AI Logic
  • بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، ويكون الموقع الجغرافي دائمًا عالميًا.
  • بالنسبة إلى Vertex AI Gemini API: عند إعداد خدمة الخلفية Vertex AI في قاعدة الرموز، يمكنك اختياريًا تحديد موقع جغرافي للوصول إلى النموذج.
    إذا لم تحدّد موقعًا جغرافيًا، ستكون المنطقة التلقائية هي us-central1.
Firebase AI Logic المواقع الجغرافية
Google Analytics عند تفعيل Google Analytics في مشروعك على Firebase في Firebase Console، سيُطلب منك اختيار موقع جغرافي لإعداد التقارير في "إحصاءات Google". عليك اختيار بلد أو منطقة تمثّل الموقع الجغرافي لمؤسستك.

إذا كنت مالك مشروع أو محرِّرًا، يمكنك تعديل المنطقة الزمنية والعملة لموقع إعداد التقارير في "إحصاءات Google" لاحقًا. انتقِل إلى إعدادات Google Analytics، ثم إلى لوحة إعداد التقارير.

يمكنك الاطّلاع على القائمة في لوحة Google Analytics الإعدادات > الإبلاغ.
Firebase App Hosting عند إنشاء App Hosting، سيُطلب منك اختيار موقع جغرافي. يمكنك استخدام وحدة تحكّم Firebase أو واجهة REST API أو واجهة سطر الأوامر Firebase لإنشاء خلفية. App Hosting موقع جغرافي
Firebase Data Connect عند توفير مثيل خدمة Data Connect، عليك ضبط مواقعه الجغرافية. يمكنك أيضًا ضبط الموقع الجغرافي لمثيل Google Cloud SQL المرتبط.
يمكنك استخدام وحدة تحكّم Firebase أو واجهة سطر الأوامر Firebase لتوفير مثيل. 		مواقع Data Connect الخدمة ومواقع مثيلات Cloud SQL
Cloud Firestore 1 عند توفير مثيل قاعدة بيانات Cloud Firestore، عليك تحديد موقعه الجغرافي. يمكنك استخدام وحدة تحكّم Firebase أو واجهة REST API أو واجهة سطر الأوامر Firebase أو Terraform لتوفير مثيل. Cloud Firestore المواقع الجغرافية
Firebase Realtime Database عند توفير مثيل Realtime Database، يمكنك ضبط موقعه الجغرافي.
يمكنك استخدام وحدة تحكّم Firebase أو واجهة REST API أو واجهة سطر الأوامر Firebase أو Terraform لتوفير مثيل. 		Realtime Database المواقع الجغرافية
Cloud Storage for Firebase 1 عند توفير حزمة Cloud Storage، يمكنك ضبط موقعها الجغرافي.
يمكنك استخدام وحدة تحكّم Firebase أو واجهة REST API أو Terraform لتوفير مساحة تخزين. 		Cloud Storage for Firebase المواقع الجغرافية
Cloud Functions for Firebase 1 عند كتابة دالة، يمكنك اختياريًا ضبط منطقتها.

إذا لم تحدّد موقعًا جغرافيًا، ستكون المنطقة التلقائية هي us-central1.

Cloud Functions for Firebase المواقع الجغرافية

1 استنادًا إلى الوقت الذي بدأت فيه استخدام هذه المنتجات في مشروعك، قد تكون هناك تبعيات متعلقة بالموقع الجغرافي بين هذه المنتجات. وقد يُشار إلى هذا التبعية باسم "الموقع الجغرافي لموارد Google Cloud التلقائية". مزيد من المعلومات عن هذه التبعية المتعلقة بالموقع الجغرافي

عرض إعدادات الموقع الجغرافي

المنتج مكان عرض إعدادات الموقع الجغرافي
Firebase AI Logic
  • بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، ويكون الموقع الجغرافي دائمًا عالميًا.
  • بالنسبة إلى Vertex AI Gemini API: في قاعدة الرموز، ابحث عن عملية تهيئة خدمة الخلفية Vertex AI. إذا لم يتم تحديد موقع جغرافي، سيكون الموقع الجغرافي التلقائي هو us-central1.
Google Analytics في وحدة تحكّم Firebase، انتقِل إلى الإعدادات إعدادات المشروع > عمليات الدمج > Google Analytics. انقر على رقم الحساب لفتح حسابك على Google Analytics، ثم انتقِل إلى لوحة المشرف للعثور على معلومات الموقع الجغرافي لحسابك.
Firebase App Hosting
  • في وحدة تحكّم Firebase، انتقِل إلى صفحة App Hosting للاطّلاع على قائمة بالخوادم الخلفية ومواقعها الجغرافية.
  • لعرض الموقع الجغرافي لخادم خلفي معيّن، يمكنك استخدام أمر Firebase في واجهة سطر الأوامر firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Firebase Data Connect في وحدة تحكّم Firebase، انتقِل إلى صفحة Data Connect لعرض قائمة بمثيلات قاعدة البيانات ومواقعها الجغرافية.
Cloud Firestore في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب Cloud Firestore البيانات للاطّلاع على قائمة بمثيلات قاعدة البيانات ومواقعها الجغرافية.
Firebase Realtime Database في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب Realtime Database البيانات للاطّلاع على قائمة بمثيلات قاعدة البيانات ومواقعها الجغرافية.
Cloud Storage for Firebase في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب Cloud Storage الملفات للاطّلاع على قائمة بالحِزم ومواقعها.
Cloud Functions for Firebase
  • الدوال المجدوَلة: في وحدة تحكّم Google Cloud، انتقِل إلى Cloud Scheduler للاطّلاع على قائمة المواضيع لكل مهمة ودالة. الموقع الجغرافي هو الجزء الأخير من اسم الموضوع.
  • الدوال غير المجدوَلة: في رمز المصدر الخاص بالدالة، ابحث عن المَعلمة region. إذا لم يتم تحديد منطقة، سيكون الموقع الجغرافي التلقائي هو us-central1.

اعتمادات محتملة على الموقع الجغرافي بسبب "الموقع الجغرافي لموارد Google Cloud التلقائية"

"الموقع الجغرافي لموارد Google Cloud التلقائية" هو إعداد الموقع الجغرافي لأي موارد مشاريع مرتبطة بـ App Engine من Google، بما في ذلك ما يلي:

  • مثيل قاعدة بيانات Cloud Firestore التلقائي
  • القيمة التلقائية Cloud Storage لحزمة Firebase بتنسيق الاسم *.appspot.com
  • ‫Google Cloud Scheduler المستخدَم تحديدًا مع الجيل الأول من الدوال المجدوَلة

"موقع الموارد التلقائية Google Cloud" هو إعداد غير قابل للتغيير. بالإضافة إلى ذلك، عند ضبط الموقع الجغرافي لأحد المراجع المرتبطة، يتم ضبط الموقع الجغرافي لجميع المراجع بشكل غير مباشر بسبب ارتباطها المشترك بـ App Engine.

ومع ذلك، مع حدوث العديد من التغييرات في نظام Firebase وGoogle Cloud على مر السنين، تغيّرت عمليات ربط الموارد بـ App Engine. والأهم من ذلك، أنّه اعتبارًا من 30 أكتوبر 2024، سيكون تنسيق الاسم *.firebasestorage.app هو التنسيق التلقائي Cloud Storage لجميع حِزم Firebase التي يتم توفيرها حديثًا، ولن تكون مرتبطة بـ App Engine.

في ما يلي تفاصيل التغييرات التي طرأت على التبعيات المحتملة للموقع الجغرافي:

  • اعتبارًا من 30 أكتوبر 2024، في حال لم يتم توفيرCloud Firestore التلقائي وCloud Storage التلقائي لحزمة Firebase بعد:

    • يؤدي توفير مثيل Cloud Firestore التلقائي إلى ضبط الموقع الجغرافي لأي تطبيق App Engine يتم توفيره في المشروع مستقبلاً. ومع ذلك، لا يحدّد هذا الإعداد موقع الحزمة Cloud Storage التلقائية المستقبلية.

    • لم يعُد توفير حزمة Cloud Storage التلقائية يوفّر تطبيق App Engine. وبالتالي، فإنّ موقع حزمة Cloud Storage التلقائية لا يحدّد موقع مثيل Cloud Firestore التلقائي المستقبلي.

  • اعتبارًا من 30 أكتوبر 2024، في حال تم توفير مثيل Cloud Firestore التلقائي سابقًا، ولكن لم يتم توفير Cloud Storage التلقائي لحزمة Firebase:

    • لا يحدّد مثيل Cloud Firestore التلقائي الحالي موقع حزمة Cloud Storage التلقائية المستقبلية (*.firebasestorage.app).

  • اعتبارًا من 30 أكتوبر 2024، في حال تم توفير Cloud Storage التلقائي لحزمة Firebase (تحديدًا حزمة *.appspot.com)، ولكن لم يتم توفير مثيل Cloud Firestore التلقائي:

    • عندما تم توفير حزمة Cloud Storage التلقائية (*.appspot.com) في السابق، تم توفير تطبيق App Engine أيضًا، وبالتالي تم تحديد موقع مثيل Cloud Firestore التلقائي المستقبلي في ذلك الوقت. حتى إذا حذفت حزمة *.appspot.com، لن تتمكّن من حذف تطبيق App Engine، وبالتالي يكون إعداد الموقع الجغرافي لنسخة Cloud Firestore التلقائية المستقبلية قد تم ضبطه مسبقًا.

إذا كنت تستخدم دوال الجيل الأول من الدوال المجدوَلة، يتم ضبط موقعها الجغرافي على الموقع الجغرافي لموارد Google Cloud التلقائية. ويرجع ذلك إلى أنّ Cloud Scheduler وApp Engine كانا مرتبطَين ببعضهما في السابق. بالإضافة إلى ذلك، إذا أعددت وظائف مجدولة من الجيل الأول قبل توفير موارد أخرى تشارك إعدادات الموقع الجغرافي هذه، عليك ضبط الموقع الجغرافي لهذه الموارد أيضًا.

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

  • لمزيد من المعلومات حول إنشاء تطبيقات تستوفي متطلبات وقت الاستجابة ومدى التوفّر والمتانة، يُرجى الرجوع إلى الموقع الجغرافي والمناطق.