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

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

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

المنتج الموقع الجغرافي التلقائي معلومات إضافية
Firebase AI Logic
  • بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، يكون دائمًا global.
  • بالنسبة إلى Agent Platform Gemini API (formerly Vertex AI): إذا لم يتم ضبط الموقع الجغرافي، تكون المنطقة التلقائية 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. يمكن أن تكون كل دالة في موقع جغرافي مختلف.

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

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

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

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

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

إذا كنت مالك مشروع أو محررًا، يمكنك لاحقًا تعديل المنطقة الزمنية والعملة لموقع إعداد التقارير في "إحصاءات 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 المواقع الجغرافية

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

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

المنتج مكان عرض إعداد الموقع الجغرافي
Firebase AI Logic
  • بالنسبة إلى Gemini Developer API: لا يمكن اختيار الموقع الجغرافي، يكون دائمًا global.
  • بالنسبة إلى Agent Platform Gemini API (formerly Vertex AI): في قاعدة الرموز البرمجية، ابحث عن تهيئة خدمة الخلفية Agent Platform. إذا لم يتم تحديد موقع جغرافي ، يكون الموقع الجغرافي التلقائي us-central1.
Google Analytics في Firebase console، انتقِل إلى 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 في Firebase التي يكون تنسيق اسمها *.appspot.com
  • Google Cloud Scheduler المستخدَم تحديدًا مع الدوال المجدولة من الجيل الأول

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

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

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

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