Package google.research.floodforecasting.v1

الفهرس

FloodsApi

خدمة خارجية لواجهة برمجة التطبيقات لتوقّع الفيضانات

BatchGetGaugeModels

rpc BatchGetGaugeModels(BatchGetGaugeModelsRequest) returns (BatchGetGaugeModelsResponse)

الحصول على البيانات الوصفية لنموذج المياه الحالي لعدة مقاييس
BatchGetGauges

rpc BatchGetGauges(BatchGetGaugesRequest) returns (BatchGetGaugesResponse)

الحصول على بيانات وصفية حول مقاييس متعددة
GetGauge

rpc GetGauge(GetGaugeRequest) returns (Gauge)

الحصول على بيانات وصفية حول مقياس
GetGaugeModel

rpc GetGaugeModel(GetGaugeModelRequest) returns (GaugeModel)

الحصول على البيانات الوصفية لنموذج المياه الحالي لمقياس معيّن
GetSerializedPolygon

rpc GetSerializedPolygon(GetSerializedPolygonRequest) returns (SerializedPolygon)

الحصول على مضلّع مسلسَل ستظهر أرقام التعريف الخاصة بهذه العناصر في ردود واجهة برمجة التطبيقات الأخرى، وستتمكّن من استخدام أرقام التعريف هذه هنا. على سبيل المثال، اطّلِع على InundationMap في FloodStatus.
QueryGaugeForecasts

rpc QueryGaugeForecasts(QueryGaugeForecastsRequest) returns (QueryGaugeForecastsResponse)

توقّعات مقياس طلب البحث
QueryLatestFloodStatusByGaugeIds

rpc QueryLatestFloodStatusByGaugeIds(QueryLatestFloodStatusByGaugeIdsRequest) returns (QueryLatestFloodStatusByGaugeIdsResponse)

طلب البحث عن آخر حالة فيضان حسب أرقام تعريف مقاييس المياه
SearchGaugesByArea

rpc SearchGaugesByArea(SearchGaugesByAreaRequest) returns (SearchGaugesByAreaResponse)

البحث عن مقاييس حسب المنطقة الجغرافية

ملاحظة: تتم إضافة المقاييس أو إزالتها أحيانًا، لذا يجب عدم تخزين نتيجة واجهة برمجة التطبيقات هذه مؤقتًا أو حفظها لفترات طويلة. يُعدّ عدم استخدامها لأكثر من يوم واحد آمنًا نسبيًا.
SearchLatestFloodStatusByArea

rpc SearchLatestFloodStatusByArea(SearchLatestFloodStatusByAreaRequest) returns (SearchLatestFloodStatusByAreaResponse)

البحث عن آخر حالة للفيضانات حسب المنطقة الجغرافية ملاحظة: تعرض هذه السمة حالات الفيضان التي يقع مقياسها ضمن المنطقة المحدّدة، بدلاً من المنطقة المتأثرة التي تتقاطع مع المنطقة المحدّدة مثلاً. ويخضع هذا العرض إلى التغيير لاحقًا.

BatchGetGaugeModelsRequest

طلب BatchGetGaugeModels

الحقول
names[]

string

مطلوب. أسماء نماذج المقاييس المطلوب استردادها. تنسيق الاسم: gaugeModels/{gauge_id}. يقتصر حجم القائمة المتوافقة على 20,000. إذا تم تقديم قائمة أكبر من 20,000، سيتعذّر تنفيذها وسيظهر الخطأ INVALID_REQUEST.

BatchGetGaugeModelsResponse

استجابة BatchGetGaugeModels

الحقول
gauge_models[]

GaugeModel

طُرز مقاييس الأداء المطلوبة.

BatchGetGaugesRequest

طلب BatchGetGauges

الحقول
names[]

string

مطلوب. أسماء المقاييس المطلوب استردادها. تنسيق الاسم: gauges/{gauge_id}. يقتصر حجم القائمة المتوافقة على 100,000. إذا تم تقديم قائمة أكبر من 100,000، سيتعذّر ذلك وسيظهر الخطأ INVALID_REQUEST.

BatchGetGaugesResponse

استجابة BatchGetGauges.

الحقول
gauges[]

Gauge

المقاييس المطلوبة

FloodStatus

حالة الفيضان التي يصدرها النظام تمثّل هذه السمة حالة الفيضان المتوقّعة من قِبل النظام في منطقة معيّنة، مع سمات مثل درجة الخطورة والتغيير المتوقّع والخرائط المائية وغيرها. انظر أدناه للحصول على مزيد من التفاصيل.

الحقول
gauge_id

string

معرّف المقياس الذي تم إصدار هذه الحالة له.
quality_verified

bool

تكون القيمة "صحيح" إذا كان المقياس الذي تم إصدار حالة الفيضان هذه له لا يتضمّن نموذجًا، أو إذا كان يتضمّن نموذجًا وتم التحقّق من جودة النموذج. يُرجى توخّي الحذر عند ضبط هذه القيمة على "خطأ".
gauge_location

LatLng

تمثّل هذه السمة الموقع الجغرافي للمقياس الذي تم إصدار هذه الحالة له.
issued_time

string

الوقت الذي تم فيه إصدار هذه الحالة كسلسلة (ISO 8601)، مثلاً "2023-06-17T10:34:00Z".
forecast_time_range

TimeRange

النطاق الزمني الذي يتم التوقّع بشأنه.
forecast_change

ForecastChange

تغيير قيمة التوقّع من آخر حالة معروفة إلى التوقّع تتوفّر هذه الميزة حاليًا لطُرز "مستوى المياه" فقط.
forecast_trend

ForecastTrend

مؤشر التوقّعات
map_inference_type

MapInferenceType

نوع الاستنتاج الذي تم إنشاء هذه الخريطة استنادًا إليه.
severity

Severity

تمثّل هذه السمة مستوى خطورة الحالة.
inundation_map_set

InundationMapSet

مجموعة خرائط الفيضانات المستنتَجة
source

string

المؤسسة المسؤولة عن بيانات هذا المقياس، مثل GRDC وCWC وما إلى ذلك
serialized_notification_polygon_id

string

معرّف لمضلّع الإشعارات المتسلسلة، والذي يمثّل المنطقة الجغرافية التي تستخدمها Google لتحديد وقت تنبيه المستخدمين. استخدِم GetSerializedPolygon للحصول على المضلّع المتسلسل نفسه.

ForecastChange

تغيير القيمة المتوقّعة من آخر حالة معروفة إلى التوقّع تتوفّر هذه الميزة حاليًا لطُرز "مستوى المياه" فقط.

الحقول
value_change

ValueChange

التغيير المتوقّع في القيم
reference_time_range

TimeRange

النطاق الزمني للحالة المعروفة الأخيرة، والذي نتوقّع منه تغيُّر القيمة. على سبيل المثال، قد يكون لدينا نطاق زمني مرجعي مضبوط على الأمس، وتغيير في القيمة يتراوح بين 25 و30 سم. وهذا يعني أنّه تتم مقارنة ارتفاع مستوى المياه بمقدار 25 إلى 30 سم بمستوى المياه أمس، وليس بمستواه الحالي.

ValueChange

التغيير المتوقّع في القيم، أي الحدّ الأعلى والأدنى

الحقول
lower_bound

double

الحد الأدنى للتغيير المتوقّع بالمتر إذا كان التغيير بين 20 و30، ستكون هذه القيمة 20. إذا كان التغيير بين ‎-30 و‎-20، ستكون هذه القيمة ‎-30.
upper_bound

double

الحدّ الأعلى للتغيّر المتوقّع بالمتر إذا كان التغيير بين 20 و30، ستكون هذه القيمة 30. إذا كان التغيير بين -30 و-20، ستكون هذه القيمة -20.

ForecastTrend

تعداد يمثّل اتجاه التوقّعات.

عمليات التعداد
FORECAST_TREND_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
RISE يشير ذلك إلى ارتفاع في القيمة المتوقّعة.
FALL يشير ذلك إلى انخفاض في القيمة المتوقّعة.
NO_CHANGE يشير ذلك إلى عدم حدوث تغيير في القيمة المتوقّعة.

InundationMap

خريطة فيضان واحدة

الحقول
level

InundationLevel

مستوى خريطة الفيضانات: يمكنك الاطّلاع على المستندات استنادًا إلى InundationMapType.
serialized_polygon_id

string

معرّف المضلّع المتسلسل الذي يمثّل خريطة مخاطر الفيضانات هذه. استخدِم GetSerializedPolygon للحصول على المضلّع المتسلسل نفسه.

InundationLevel

تعداد يمثّل مستويات الفيضانات.

عمليات التعداد
INUNDATION_LEVEL_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
HIGH اطّلِع على المستندات استنادًا إلى InundationMapType.
MEDIUM اطّلِع على المستندات استنادًا إلى InundationMapType.
LOW اطّلِع على المستندات استنادًا إلى InundationMapType.

InundationMapSet

مجموعة من خرائط الفيضانات

الحقول
inundation_maps[]

InundationMap

خرائط الفيضانات، واحدة لكل مستوى من مستويات الفيضانات
inundation_maps_time_range

TimeRange

النطاق الزمني للحالة التي تشير إليها خرائط الفيضانات
inundation_map_type

InundationMapType

تمثّل هذه السمة نوع خريطة الفيضانات.

InundationMapType

تعداد يمثّل نوع خريطة الفيضانات.

عمليات التعداد
INUNDATION_MAP_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
PROBABILITY خريطة لاحتمالية النوع يمثّل InundationLevel احتمال الخريطة، أي احتمال حدوث فيضان بنسبة عالية أو متوسطة أو منخفضة. يقع المضلّع ذو الاحتمالية العالية داخل المضلّع ذو الاحتمالية المتوسطة، ويقع المضلّع ذو الاحتمالية المتوسطة داخل المضلّع ذو الاحتمالية المنخفضة.
DEPTH خريطة لعمق النوع يمثّل InundationLevel عمق الخريطة: عمق مرتفع أو متوسط أو منخفض لكل موقع جغرافي. يقع المضلّع ذو العمق العالي داخل المضلّع ذو العمق المتوسط، ويقع المضلّع ذو العمق المتوسط داخل المضلّع ذو العمق المنخفض.

MapInferenceType

تعداد يمثّل أنواع استنتاجات الخريطة.

عمليات التعداد
MAP_INFERENCE_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
MODEL يشير ذلك إلى أنّ هذا الاستنتاج تم إنشاؤه باستخدام نموذج.
IMAGE_CLASSIFICATION يشير ذلك إلى أنّ هذا الاستنتاج تم إنشاؤه باستخدام تصنيف الصور.

درجة الخطورة

تعداد يمثّل درجة خطورة الحالة.

عمليات التعداد
SEVERITY_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
EXTREME يشير ذلك إلى حالة قصوى متوقّعة.
SEVERE يشير ذلك إلى حالة شديدة متوقّعة.
ABOVE_NORMAL تشير هذه الحالة إلى أنّ التوقعات تشير إلى أنّ مستوى النشاط سيكون أعلى من المعتاد.
NO_FLOODING يشير هذا إلى توقّع بعدم حدوث فيضانات.
UNKNOWN يشير ذلك إلى عدم توفّر معلومات كافية لتحديد درجة الخطورة.

التوقعات

توقّعات مقياس واحد لعدّة فترات زمنية متقدّمة على سبيل المثال، يمكن أن يكون وقت الإصدار في التوقّعات هو الساعة 5 مساءً، وأن تتضمّن التوقّعات الساعة 6 مساءً و7 مساءً و8 مساءً وما إلى ذلك.

ملاحظة: يمكن أن تكون بعض نطاقات التوقعات أقدم من وقت الإصدار. قد يحدث ذلك بسبب تأخُّر في بيانات الإدخال للنموذج، على سبيل المثال. في المثال أعلاه، قد يكون وقت حدوث المشكلة هو الساعة 5 مساءً، وتكون نطاقات التوقعات للساعة 4 مساءً و5 مساءً و6 مساءً وما إلى ذلك.

ملاحظة: تختلف النطاقات في طولها والمسافة بينها. في ما يلي بعض الأمثلة على النطاقات المحتملة:

  1. [5pm - 5pm], [6pm - 6pm], [7pm - 7pm]

  2. [من 1 مارس الساعة 12 صباحًا إلى 2 مارس الساعة 12 صباحًا]، [من 2 مارس الساعة 12 صباحًا إلى 3 مارس الساعة 12 صباحًا]، [من 3 مارس الساعة 12 صباحًا إلى 4 مارس الساعة 12 صباحًا]

الحقول
forecast_ranges[]

ForecastTimedValue

تتألف التوقعات من عدة "نطاقات توقعات"، وهي عبارة عن قيم توقعات مختلفة تتعلق بنطاقات زمنية مختلفة. عندما يتساوى بداية ونهاية النطاق، يعني ذلك أنّه لحظة زمنية.
gauge_id

string

معرّف المقياس الذي تتعلّق به هذه التوقّعات.
issued_time

string

تمثّل هذه السمة وقت إصدار التوقّعات (ISO 8601)، مثلاً "2023-06-17T10:34:00Z". يشير وقت الإصدار إلى الوقت الذي تم فيه إنشاء التوقّع.

ForecastSet

مجموعة من التوقعات لمقياس.

الحقول
forecasts[]

Forecast

التوقّعات

ForecastTimedValue

قيمة توقّعية مرتبطة بنطاق زمني يتم تحديد وحداته من خلال GaugeModel المرتبط به. إذا كان وقت البدء ووقت الانتهاء متساويَين، يعني ذلك أنّه وقت فوري.

الحقول
value

double

تمثّل هذه السمة قيمة التوقّع.
forecast_start_time

string

بداية الفاصل الزمني
forecast_end_time

string

نهاية الفاصل الزمني

مقياس

البيانات الوصفية لمقياس

الحقول
location

LatLng

تمثّل هذه السمة الموقع الجغرافي الفعلي للمقياس.
site_name

string

تمثّل هذه السمة اسم الموقع الذي يقع فيه مقياس الأداء، باللغة الإنجليزية. هذا ليس معرّفًا فريدًا، فقد تكون هناك عدة مقاييس في مواقع قريبة تحمل اسم الموقع الإلكتروني نفسه. لا تكون هذه السمة متوفّرة دائمًا.
source

string

المؤسسة المسؤولة عن بيانات مقياس الأداء هذا، مثل GRDC وCWC وما إلى ذلك
river

string

تمثّل هذه السمة اسم النهر الذي يقع فيه مقياس المياه باللغة الإنجليزية. لا تكون هذه السمة متوفّرة دائمًا.
country_code

string

تمثّل هذه السمة رمز البلد الذي يقع فيه مقياس الأداء (ISO 3166 Alpha-2).
gauge_id

string

معرّف المقياس.
quality_verified

bool

تكون قيمة هذا الحقل صحيحة إذا لم يكن للمقياس نموذج، أو إذا كان له نموذج وتم التحقّق من جودته. يُرجى توخّي الحذر عند ضبط هذه القيمة على "خطأ".
has_model

bool

تكون قيمة هذا الحقل صحيحة إذا كان المقياس يحتوي على نموذج. إذا كان المقياس يتضمّن نموذجًا، يمكن الحصول على GaugeModel لهذا المقياس باستخدام GetGaugeModel أو BatchGetGaugeModels. ويمكنك أيضًا الحصول على توقعاته باستخدام QueryGaugeForecasts.

GaugeModel

البيانات الوصفية لنموذج مقياس

الحقول
gauge_id

string

معرّف المقياس.
gauge_model_id

string

معرّف نموذج المقياس. قد يتغيّر نموذج المقياس من وقت لآخر، وفي هذه الحالة سنحدّد معرّفًا جديدًا وحدودًا دنيا وعليا جديدة للنموذج الجديد. يُرجى توخّي الحذر عند مقارنة التوقعات القديمة بالتوقعات الجديدة إذا تم إنتاجها باستخدام نماذج مختلفة.
thresholds

Thresholds

حدود المقياس
gauge_value_unit

GaugeValueUnit

وحدة القيمة لنموذج المقياس
quality_verified

bool

تُستخدَم لتحديد ما إذا تم التحقّق من جودة هذا النموذج. يُرجى توخّي الحذر عند ضبط هذه القيمة على "خطأ".

GaugeValueUnit

وحدات قيمة المقياس المحتملة

عمليات التعداد
GAUGE_VALUE_UNIT_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
METERS متر
CUBIC_METERS_PER_SECOND متر مكعّب في الثانية

GetGaugeModelRequest

طلب GetGaugeModel

الحقول
name

string

مطلوب. اسم نموذج المقياس المطلوب استرداده. تنسيق الاسم: gaugeModels/{gauge_id}.

GetGaugeRequest

طلب GetGauge

الحقول
name

string

مطلوب. تمثّل هذه السمة اسم المقياس المطلوب استرداده. تنسيق الاسم: gauges/{gauge_id}.

GetSerializedPolygonRequest

طلب GetSerializedPolygon

الحقول
name

string

مطلوب. تمثّل هذه السمة اسم المضلّع المتسلسل المطلوب استرداده. تنسيق الاسم: serializedPolygons/{polygon_id}

التكرار

حلقة على الخريطة تمثّل هذه السمة مضلّعًا كرويًا بسيطًا. وهي تتألف من سلسلة واحدة من الرؤوس حيث يكون الرأس الأول مرتبطًا ضمنيًا بالرأس الأخير.

الحقول
vertices[]

LatLng

مطلوب. رؤوس الحلقة

QueryGaugeForecastsRequest

طلب QueryGaugeForecasts

الحقول
gauge_ids[]

string

مطلوب. قائمة بمعرّفات المقاييس يقتصر حجم القائمة المتوافقة على 500. إذا تم تقديم قائمة أكبر من 500 عنصر، سيتعذّر ذلك وسيظهر الخطأ INVALID_REQUEST.
issued_time_start

string

اختياريّ. تمثّل هذه السمة أبكر وقت تم فيه إصدار توقعات الطقس كسلسلة (ISO 8601)، مثلاً "2023-06-17T10:34:00Z" أو سلسلة تاريخ، مثلاً "2023-10-13". لا يمكن أن يكون وقت البدء قبل "2023-10-01". القيمة التلقائية هي قبل أسبوع واحد.
issued_time_end

string

اختياريّ. تمثّل هذه السمة آخر وقت تم فيه إصدار التوقّعات كسلسلة (ISO 8601)، مثلاً "2023-06-17T10:34:00Z" أو سلسلة تاريخ، مثلاً "2023-10-13". القيمة التلقائية هي "الآن".

QueryGaugeForecastsResponse

تمثّل هذه السمة استجابة QueryGaugeForecasts.

الحقول
forecasts

map<string, ForecastSet>

خريطة من معرّف المقياس إلى مجموعة التوقعات

QueryLatestFloodStatusByGaugeIdsRequest

طلب QueryLatestFloodStatusByGaugeIds

الحقول
gauge_ids[]

string

مطلوب. قائمة بمعرّفات المقاييس يقتصر حجم القائمة المتوافقة على 20,000. إذا تم تقديم قائمة أكبر من 20,000، سيتعذّر تنفيذها وسيظهر الخطأ INVALID_REQUEST.

QueryLatestFloodStatusByGaugeIdsResponse

ردّ QueryLatestFloodStatusByGaugeIds

الحقول
flood_statuses[]

FloodStatus

أحدث حالات الفيضانات للمقاييس المطلوبة

SearchGaugesByAreaRequest

طلب SearchGaugesByArea

الحقول
page_size

int32

اختياريّ. الحدّ الأقصى لعدد المقاييس المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50,000 مقياس على الأكثر. الحد الأقصى للقيمة هو 50,000، وسيتم فرض القيمة 50,000 على القيم التي تزيد عن 50,000.
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب SearchGauges سابق. قدِّم هذه السلسلة لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى SearchGauges مع الطلب الذي قدّم رمز الصفحة المميز.

حقل الدمج search_by

يمكن أن تكون search_by إحدى القيم التالية فقط:
region_code

string

البحث عن جميع مقاييس الأداء ضِمن منطقة معيّنة باستخدام رمز المنطقة استخدِم https://cldr.unicode.org/ (القائمة https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry).
loop

Loop

ابحث عن جميع أدوات القياس ضمن حلقة (مضلّع كروي بسيط، اطّلِع على Loop).
include_non_quality_verified

bool

اختياريّ. تضمين مقاييس النتائج التي لم يتم التحقّق من جودتها يُرجى استخدامه بحذر. القيمة التلقائية هي "خطأ".
include_gauges_without_hydro_model

bool

اختياريّ. تضمين مقاييس النتائج التي لا تتضمّن نموذجًا هيدرولوجيًا داخليًا من Google القيمة التلقائية هي "خطأ".

SearchGaugesByAreaResponse

استجابة SearchGaugesByArea

الحقول
gauges[]

Gauge

مقاييس تم العثور عليها في المنطقة المطلوبة
next_page_token

string

اختياريّ. رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

SearchLatestFloodStatusByAreaRequest

طلب SearchLatestFloodStatusByArea

الحقول
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب SearchLatestFloodStatusByArea سابق. قدِّم هذه السلسلة لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى SearchLatestFloodStatusByArea مع الطلب الذي قدّم رمز الصفحة المميز.
page_size

int32

اختياريّ. الحدّ الأقصى لعدد حالات الفيضانات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 20,000 حالة فيضان على الأكثر. الحد الأقصى للقيمة هو 20,000، وسيتم فرض القيمة 20,000 على القيم التي تزيد عن 20,000.

حقل الدمج area_type

يمكن أن تكون area_type إحدى القيم التالية فقط:
region_code

string

المنطقة التي سيتم الاستعلام عن حالات الفيضان فيها باستخدام CLDR، على سبيل المثال: ‫'US'.
loop

Loop

الحلقة التي سيتم من خلالها طلب حالات الفيضانات.
include_non_quality_verified

bool

اختياريّ. تضمين مقاييس النتائج التي لم يتم التحقّق من جودتها يُرجى استخدامه بحذر. القيمة التلقائية هي "خطأ".

SearchLatestFloodStatusByAreaResponse

استجابة SearchLatestFloodStatusByArea

الحقول
flood_statuses[]

FloodStatus

أحدث حالات الفيضان في المنطقة المطلوبة يتم تحديد ذلك حاليًا حسب موقع المؤشرات، ولكن قد يتغيّر ذلك في المستقبل.
next_page_token

string

اختياريّ. رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

SerializedPolygon

مضلّع مسلسَل

الحقول
polygon_id

string

معرّف المضلّع.
kml

string

تمثيل المضلّع كسلسلة KML

الحدود

حدود نموذج المقياس

الحقول
warning_level

double

مستوى التحذير
danger_level

double

مستوى الخطورة
extreme_danger_level

double

مستوى الخطر الشديد لا تكون هذه السمة متوفّرة دائمًا.

TimeRange

نطاق زمني

الحقول
start

string

تمثّل هذه السمة بداية النطاق الزمني. يتم تمثيله بتنسيق ISO 8601، مثلاً: "2023-06-17T10:34:00Z".
end

string

تمثّل هذه السمة نهاية النطاق الزمني. يتم تمثيله بتنسيق ISO 8601، مثلاً: "2023-06-17T10:34:00Z".