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

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

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

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

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

Firebase AI Logic موقع جغرافي
Google Analytics عند تفعيل Google Analytics في مشروعك على Firebase في وحدة تحكُّم Firebase، سيُطلب منك اختيار موقع جغرافي لإعداد تقارير "إحصاءات Google". عليك اختيار بلد أو منطقة يمثّلان الموقع الجغرافي لمؤسستك.

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

اطّلِع على القائمة في pane إعدادات Google Analytics > إعداد التقارير.
App Hosting عند إنشاء خلفية App Hosting، سيُطلب منك اختيار موقع جغرافي. يمكنك استخدام وحدة تحكّم Firebase أو REST API أو Firebase CLI لإنشاء خلفية. App Hosting موقع جغرافي
Data Connect عند توفير مثيل خدمة Data Connect، يمكنك ضبط مواقعه الجغرافية. يمكنك أيضًا ضبط الموقع الجغرافي لمثيل Google Cloud SQL المرتبط.
يمكنك استخدام وحدة تحكّم Firebase أو Firebase CLI لتوفير مثيل. 		مواقع خدمة Data Connect ومثيل Cloud SQL
Cloud Firestore 1 عند توفير مثيل قاعدة بيانات Cloud Firestore، يمكنك ضبط موقعه الجغرافي. يمكنك استخدام وحدة تحكّم Firebase أو واجهة برمجة التطبيقات REST أو Firebase CLI أو Terraform لتوفير مثيل. Cloud Firestore موقع جغرافي
Realtime Database عند توفير مثيل Realtime Database، يمكنك تحديد موقعه الجغرافي.
يمكنك استخدام وحدة تحكّم Firebase أو واجهة برمجة التطبيقات REST API أو Firebase CLI أو 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 التلقائية". اطّلِع على مزيد من المعلومات عن الاعتماد على الموقع الجغرافي.

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

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

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

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

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

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

ومع ذلك، مع إجراء العديد من التغييرات على منظومة Firebase وGoogle Cloud على مدار السنين، تغيّرت عمليات ربط الموارد بـ App Engine. من الجدير بالذكر أنّه اعتبارًا من 30 تشرين الأول (أكتوبر) 2024، ستتضمّن جميع Cloud Storage التلقائية التي تم توفيرها حديثًا لمجموعات Firebase تنسيق الاسم *.firebasestorage.app، ولن تكون مرتبطة بـ 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. بالإضافة إلى ذلك، في حال إعداد وظائف مجدوَلة من الجيل الأول قبل توفير موارد أخرى تشارك إعداد الموقع الجغرافي هذا، يمكنك عندئذٍ تحديد موقعها الجغرافي أيضًا.

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