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

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

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

المنتج الموقع الجغرافي التلقائي معلومات إضافية
Firebase AI Logic
  • بالنسبة إلى Gemini Developer API: لا يمكن اختيار موقع جغرافي، ويكون النطاق دائمًا عالميًا.
  • بالنسبة إلى Vertex AI Gemini API: إذا لم يتم ضبط الموقع الجغرافي، ستكون المنطقة التلقائية هي us-central1.
هذا هو المكان الذي يمكنك فيه الوصول إلى النموذج.
Google Analytics ما مِن موقع جغرافي تلقائي
يجب تحديد هذا الموقع الجغرافي. 		هذا الموقع الجغرافي هو Analytics موقع إعداد التقارير2، والذي يمثّل بلد مؤسستك أو منطقتها. يحدّد Analytics موقع إعداد التقارير العملة المستخدَمة في إعداد تقارير الأرباح.
Firebase App Hosting ما مِن موقع جغرافي تلقائي
يجب ضبط هذا الموقع الجغرافي لكل نظام خلفي. 		هذا الموقع الجغرافي هو المكان الذي تنشئ فيه عملية App Hosting النشر كل موارد الخلفية.
يمكن أن يكون كل نظام خلفي في موقع جغرافي مختلف.
Firebase SQL 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، سيُطلب منك اختيار موقع جغرافي لإعداد التقارير في "إحصاءات Google". عليك اختيار بلد أو منطقة تمثّل الموقع الجغرافي لمؤسستك.

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

يمكنك الاطّلاع على القائمة في لوحة إعدادات Google Analytics > إعداد التقارير.
Firebase App Hosting عند إنشاء App Hosting، سيُطلب منك اختيار موقع جغرافي. يمكنك استخدام وحدة تحكّم Firebase أو واجهة REST API أو واجهة سطر الأوامر Firebase لإنشاء خلفية. App Hosting موقع جغرافي
Firebase SQL Connect عند توفير مثيل خدمة SQL Connect، عليك ضبط المواقع الجغرافية الخاصة به. يمكنك أيضًا ضبط الموقع الجغرافي لنسخة Google Cloud SQL المرتبطة.
يمكنك استخدام وحدة تحكّم Firebase أو واجهة سطر الأوامر Firebase لتوفير مثيل. 		مواقع SQL 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 SQL Connect في وحدة تحكّم Firebase، انتقِل إلى صفحة SQL 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 كانا مرتبطَين ببعضهما في السابق. بالإضافة إلى ذلك، إذا أعددت وظائف مجدولة من الجيل الأول قبل توفير موارد أخرى تشارك إعداد الموقع الجغرافي هذا، عليك ضبط موقعها الجغرافي أيضًا.

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

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