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

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

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

المنتج	الموقع الجغرافي التلقائي	معلومات إضافية
Firebase AI Logic	بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، يكون دائمًا global. بالنسبة إلى Vertex AI Gemini API: إذا لم يتم ضبط الموقع الجغرافي، تكون المنطقة التلقائية us-central1.	هذا هو الموقع الجغرافي الذي يمكنك من خلاله الوصول إلى النموذج.
Google Analytics	لا يوجد موقع جغرافي تلقائي. يجب ضبط هذا الموقع الجغرافي.	هذا هو موقع إعداد تقارير Analytics2، الذي يمثّل بلد مؤسستك أو منطقتها. ويضبط موقع إعداد تقارير 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.	يمكن أن تكون كل دالة في موقع جغرافي مختلف.

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

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

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

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

المنتج	وقت ضبط الموقع الجغرافي وكيفية ضبطه	المواقع الجغرافية المتاحة
Firebase AI Logic	بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، يكون دائمًا global. بالنسبة إلى 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 console أو REST API أو Firebase CLI لإنشاء نظام خلفي.	مواقعApp Hosting
Firebase SQL Connect	عند توفير مثيل خدمة SQL Connect، يتم ضبط مواقعها الجغرافية. يتم أيضًا ضبط موقع المثيل المرتبط Google Cloud SQL. يمكنك استخدام الـ Firebase console أو الـ Firebase CLI لتوفير مثيل.	مواقع خدمة SQL Connect وCloud SQL مثيل
Cloud Firestore 1	عند توفير مثيل قاعدة بيانات Cloud Firestore، يتم ضبط موقعه الجغرافي. يمكنك استخدام Firebase console أو REST API أو Firebase CLI أو Terraform لتوفير مثيل.	Cloud Firestore مواقع
Firebase Realtime Database	عند توفير مثيل Realtime Database، يتم ضبط موقعه الجغرافي. يمكنك استخدام Firebase console أو REST API أو Firebase CLI أو Terraform لتوفير مثيل.	Realtime Database مواقع
Cloud Storage for Firebase 1	عند توفير مساحة تخزين Cloud Storage، يتم ضبط موقعها الجغرافي. يمكنك استخدام Firebase console أو REST API أو Terraform لتوفير مساحة تخزين.	Cloud Storage for Firebase مواقع
Cloud Functions for Firebase 1	عند كتابة دالة، يمكنك اختياريًا ضبط منطقتها. إذا لم تحدّد موقعًا جغرافيًا، تكون المنطقة التلقائية us-central1.	Cloud Functions for Firebase مواقع

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

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

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

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

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

• مثيل قاعدة البيانات Cloud Firestore التلقائي
• مساحة تخزين Cloud Storage التلقائية التي يكون تنسيق اسمها *.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 for Firebase التلقائية:

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

  • _لم يعُد_ توفير مساحة تخزين Cloud Storage التلقائية يؤدي إلى توفير تطبيق App Engine. وبالتالي، _لا_ يحدّد الموقع الجغرافي لمساحة تخزين Cloud Storage التلقائية الموقع الجغرافي لمثيل Cloud Firestore التلقائي المستقبلي.Cloud StorageCloud StorageApp EngineCloud 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 التلقائية Cloud Storage (*.appspot.com)، تم توفير تطبيق App Engine أيضًا، وبالتالي تم ضبط الموقع الجغرافي لمثيل Cloud Firestore التلقائي المستقبلي في ذلك الوقت. حتى إذا حذفت مساحة التخزين *.appspot.com، لا يمكنك حذف تطبيق App Engine، لذا تم ضبط إعداد الموقع الجغرافي لمثيل Cloud Firestore التلقائي المستقبلي.

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

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

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