Package google.research.floodforecasting.v1

Dizin

FloodsApi

Sel Tahmini için harici bir API hizmeti.

BatchGetGaugeModels

rpc BatchGetGaugeModels(BatchGetGaugeModelsRequest) returns (BatchGetGaugeModelsResponse)

Birden fazla ölçüm cihazı için mevcut hidrolojik model meta verilerini alın.
BatchGetGauges

rpc BatchGetGauges(BatchGetGaugesRequest) returns (BatchGetGaugesResponse)

Birden fazla gösterge hakkında meta veri alma.
GetGauge

rpc GetGauge(GetGaugeRequest) returns (Gauge)

Bir göstergeyle ilgili meta verileri alma.
GetGaugeModel

rpc GetGaugeModel(GetGaugeModelRequest) returns (GaugeModel)

Belirli bir ölçüm cihazı için geçerli hidrolojik model meta verilerini alın.
GetSerializedPolygon

rpc GetSerializedPolygon(GetSerializedPolygonRequest) returns (SerializedPolygon)

Serileştirilmiş bir poligon alın. Bunların kimlikleri diğer API yanıtlarında görünür ve bu kimlikleri burada kullanabilirsiniz. Örneğin, FloodStatus içinde InundationMap ifadesine bakın.
QueryGaugeForecasts

rpc QueryGaugeForecasts(QueryGaugeForecastsRequest) returns (QueryGaugeForecastsResponse)

Sorgu göstergesi tahminleri.
QueryLatestFloodStatusByGaugeIds

rpc QueryLatestFloodStatusByGaugeIds(QueryLatestFloodStatusByGaugeIdsRequest) returns (QueryLatestFloodStatusByGaugeIdsResponse)

Ölçüm cihazı kimliklerine göre en son sel durumunu sorgulayın.
SearchGaugesByArea

rpc SearchGaugesByArea(SearchGaugesByAreaRequest) returns (SearchGaugesByAreaResponse)

Ölçüm cihazlarını coğrafi alana göre arama

Not: Göstergeler bazen eklenir veya kaldırılır. Bu nedenle, bu API'nin sonucu uzun süre önbelleğe alınmamalı ya da depolanmamalıdır. Bir günden uzun süre saklanan verilerin güvenli olmadığını unutmayın.
SearchLatestFloodStatusByArea

rpc SearchLatestFloodStatusByArea(SearchLatestFloodStatusByAreaRequest) returns (SearchLatestFloodStatusByAreaResponse)

Coğrafi bölgeye göre en son sel durumunu arayın. Not: Örneğin, verilen alanla kesişen etkilenen alan yerine, ölçüm cihazı verilen alan içinde olan sel durumlarını döndürür. Bu durum gelecekte değişebilir.

BatchGetGaugeModelsRequest

BatchGetGaugeModels isteği.

Alanlar
names[]

string

Zorunlu. Alınacak gösterge modeli adları. Ad biçimi: gaugeModels/{gauge_id}. Desteklenen liste boyutu 20.000 ile sınırlıdır. 20.000'den büyük bir liste sağlanırsa INVALID_REQUEST hatasıyla başarısız olur.

BatchGetGaugeModelsResponse

BatchGetGaugeModels'in yanıtı.

Alanlar
gauge_models[]

GaugeModel

İstenen gösterge modelleri.

BatchGetGaugesRequest

BatchGetGauges isteği.

Alanlar
names[]

string

Zorunlu. Alınacak gösterge adları. Ad biçimi: gauges/{gauge_id}. Desteklenen liste boyutu 100.000 ile sınırlıdır. 100.000'den büyük bir liste sağlanırsa INVALID_REQUEST hatasıyla başarısız olur.

BatchGetGaugesResponse

BatchGetGauges'un yanıtı.

Alanlar
gauges[]

Gauge

İstenen göstergeler.

FloodStatus

Sistem tarafından yayınlanan sel durumu. Bir bölge için sistem tarafından tahmin edilen sel durumunu, şiddet, tahmin değişikliği ve su baskını haritaları gibi özelliklerle birlikte gösterir. Daha ayrıntılı bilgi edinmek için aşağıdaki bölümü inceleyin.

Alanlar
gauge_id

string

Bu durumun yayınlandığı göstergenin kimliği.
quality_verified

bool

Bu sel durumu için verilen ölçüm cihazının modeli yoksa veya modeli varsa ve modelin kalitesi doğrulanmışsa değer "doğru"dur. Bu değer yanlış olarak ayarlandığında lütfen dikkatli kullanın.
gauge_location

LatLng

Bu durumun verildiği ölçüm cihazının konumu.
issued_time

string

Bu durumun dize olarak (ISO 8601) verildiği zaman. Örneğin: "2023-06-17T10:34:00Z".
forecast_time_range

TimeRange

Tahminin yapıldığı zaman aralığıdır.
forecast_change

ForecastChange

Tahmin değerinin, bilinen son durumdan tahmine kadar olan değişimi. Şu anda yalnızca su seviyesi modellerinde kullanılabilir.
forecast_trend

ForecastTrend

Tahminin trendi.
map_inference_type

MapInferenceType

Bu haritanın oluşturulduğu çıkarım türü.
severity

Severity

Durumun ciddiyeti.
inundation_map_set

InundationMapSet

Tahmini su baskını haritası grubu.
source

string

Bu göstergenin verilerinden sorumlu kuruluş (ör. GRDC, CWC vb.
serialized_notification_polygon_id

string

Google'ın kullanıcılarını ne zaman uyaracağını belirlemek için kullandığı coğrafi alanı temsil eden, serileştirilmiş bildirim poligonunun kimliği. Serileştirilmiş poligonun kendisini almak için GetSerializedPolygon kullanın.

ForecastChange

Son bilinen durumdan tahmine kadar olan öngörülen değer değişikliği. Şu anda yalnızca su seviyesi modellerinde kullanılabilir.

Alanlar
value_change

ValueChange

Değerlerdeki öngörülen değişiklik.
reference_time_range

TimeRange

Değer değişikliğini tahmin ettiğimiz, bilinen son durumun zaman aralığı. Örneğin, referans zaman aralığı dün olarak ayarlanmış ve değer değişikliği 25-30 cm olabilir. Bu, 25-30 cm'lik su seviyesi yükselişinin şu anki değeriyle değil, dünkü değeriyle karşılaştırıldığı anlamına gelir.

ValueChange

Değerlerdeki tahmin edilen değişiklik (üst ve alt sınır).

Alanlar
lower_bound

double

Tahmindeki değişikliğin metre cinsinden alt sınırı. Değişiklik 20 ile 30 arasındaysa bu değer 20 olur. Değişiklik -30 ile -20 arasındaysa bu değer -30 olur.
upper_bound

double

Tahmindeki değişikliğin metre cinsinden üst sınırı. Değişiklik 20 ile 30 arasındaysa bu değer 30 olur. Değişiklik -30 ile -20 arasındaysa bu değer -20 olur.

ForecastTrend

Tahminin trendini temsil eden bir enum.

Sıralamalar
FORECAST_TREND_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
RISE Bu, tahmin edilen değerde artış olduğunu gösterir.
FALL Bu, tahmin edilen değerde düşüş olduğunu gösterir.
NO_CHANGE Bu, öngörülen değerde değişiklik olmadığını gösterir.

InundationMap

Bir su baskını haritası.

Alanlar
level

InundationLevel

Su baskını haritasının seviyesi: InundationMapType'a göre dokümanları inceleyin.
serialized_polygon_id

string

Bu sel riski haritasını temsil eden, serileştirilmiş poligonun kimliği. Serileştirilmiş poligonun kendisini almak için GetSerializedPolygon kullanın.

InundationLevel

Su baskını seviyelerini temsil eden bir enum.

Sıralamalar
INUNDATION_LEVEL_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
HIGH InundationMapType'a göre dokümanlara bakın.
MEDIUM InundationMapType'a göre dokümanlara bakın.
LOW InundationMapType'a göre dokümanlara bakın.

InundationMapSet

Su baskını haritaları grubu.

Alanlar
inundation_maps[]

InundationMap

Her su baskını seviyesi için bir su baskını haritası.
inundation_maps_time_range

TimeRange

Su baskını haritalarının atıfta bulunduğu durumun zaman aralığı.
inundation_map_type

InundationMapType

Su baskını haritasının türü.

InundationMapType

Su baskını haritasının türünü temsil eden bir enum.

Sıralamalar
INUNDATION_MAP_TYPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
PROBABILITY Tür olasılığı haritası. InundationLevel, harita olasılığını (yüksek/orta/düşük sel olasılığı) gösterir. Yüksek olasılık poligonu, orta olasılık poligonunun içinde, orta olasılık poligonu ise düşük olasılık poligonunun içinde yer alır.
DEPTH Derinlik türünde bir harita. InundationLevel, harita derinliğini (konum başına yüksek/orta/düşük derinlik) gösterir. Yüksek derinlikteki poligon, orta derinlikteki poligonun içinde, orta derinlikteki poligon ise düşük derinlikteki poligonun içinde yer alır.

MapInferenceType

Harita çıkarımı türlerini temsil eden bir enum.

Sıralamalar
MAP_INFERENCE_TYPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
MODEL Bu, çıkarımın bir model kullanılarak oluşturulduğunu gösterir.
IMAGE_CLASSIFICATION Bu, çıkarımın görüntü sınıflandırması kullanılarak oluşturulduğunu gösterir.

Önem derecesi

Durumun önem derecesini temsil eden bir enum.

Sıralamalar
SEVERITY_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
EXTREME Bu, tahmin edilen aşırı durumu gösterir.
SEVERE Bu, tahmin edilen ciddi durumu gösterir.
ABOVE_NORMAL Bu, normalin üzerinde bir durumun tahmin edildiğini gösterir.
NO_FLOODING Bu, sel olmayacağı tahminini gösterir.
UNKNOWN Bu, ciddiyet düzeyini belirlemek için yeterli bilgiye sahip olmadığımızı gösterir.

Tahmin

Tek bir göstergenin birkaç teslim süresi için tahmini. Örneğin, bir tahminde yayınlanma saati 17:00 olabilir ve 18:00, 19:00, 20:00 vb. saatlere ait tahminler yer alabilir.

Not: Tahmin aralıklarından bazıları, yayınlanma zamanından daha erken olabilir. Bu durum, örneğin modelin giriş verilerindeki gecikmelerden kaynaklanabilir. Yukarıdaki örnekte, yayınlanma saati 17:00 olabilir ve tahmin aralıkları 16:00, 17:00, 18:00 vb. için olabilir.

Not: Aralıklar uzunluk ve aralarındaki mesafe bakımından farklılık gösterir. Olası aralıklara ilişkin bazı örnekler:

  1. [17:00 - 17:00], [18:00 - 18:00], [19:00 - 19:00]

  2. [1 Mart 12:00 - 2 Mart 12:00], [2 Mart 12:00 - 3 Mart 12:00], [3 Mart 12:00 - 4 Mart 12:00]

Alanlar
forecast_ranges[]

ForecastTimedValue

Tahmin, farklı zaman aralıklarına ait farklı tahmin değerleri olan çeşitli "tahmin aralıklarından" oluşur. Bir aralığın başlangıcı ve bitişi eşit olduğunda bu, anlık bir zaman olduğu anlamına gelir.
gauge_id

string

Bu tahminin yapıldığı göstergenin kimliği.
issued_time

string

Hava durumu tahmininin yayınlanma zamanı (ISO 8601), ör. "2023-06-17T10:34:00Z". Verilme zamanı, tahminin oluşturulduğu zamandır.

ForecastSet

Bir ölçüm için tahmin grubu.

Alanlar
forecasts[]

Forecast

Tahminler

ForecastTimedValue

Bir zaman aralığıyla ilgili tahmin değeri. Birimleri, ilişkilendirildiği GaugeModel ile tanımlanır. Başlangıç ve bitiş eşitse bu, anlık bir zaman olduğu anlamına gelir.

Alanlar
value

double

Tahminin değeri.
forecast_start_time

string

Aralığın başlangıcı.
forecast_end_time

string

Aralığın sonu.

Gösterge

Bir ölçüm cihazının meta verileri.

Alanlar
location

LatLng

Ölçüm cihazının fiziksel konumu.
site_name

string

Bu ölçümün bulunduğu sitenin İngilizce adı. Bu, benzersiz bir tanımlayıcı değildir. Yakın yerlerde aynı site adına sahip birkaç ölçüm cihazı olabilir. Her zaman mevcut değildir.
source

string

Bu ölçüm cihazının verilerinden sorumlu kuruluş (ör.GRDC, CWC vb.).
river

string

Ölçüm cihazının İngilizce nehir adı. Her zaman mevcut değildir.
country_code

string

Ölçüm cihazının bulunduğu ülkenin ülke kodu (ISO 3166 Alpha-2).
gauge_id

string

Göstergenin kimliği.
quality_verified

bool

Ölçüm cihazının modeli yoksa veya modeli varsa ve kalite açısından doğrulanmışsa bu alan doğrudur. Bu değer yanlış olarak ayarlandığında lütfen dikkatli kullanın.
has_model

bool

Ölçüm cihazında model varsa bu alan doğru olur. Göstergenin modeli varsa GetGaugeModel veya BatchGetGaugeModels kullanarak bu göstergenin GaugeModel değerini alabilirsiniz. Ayrıca QueryGaugeForecasts kullanarak tahminlerini de alabilirsiniz.

GaugeModel

Bir göstergenin modelinin meta verileri.

Alanlar
gauge_id

string

Göstergenin kimliği.
gauge_model_id

string

Ölçüm cihazı modelinin kimliği. Zaman zaman bir göstergenin modeli değişebilir. Bu durumda, yeni modele yeni bir kimlik ve yeni eşikler atanır. Eski tahminler farklı modeller tarafından oluşturulduysa lütfen yeni tahminlerle karşılaştırırken dikkatli olun.
thresholds

Thresholds

Ölçüm tesisi eşikleri.
gauge_value_unit

GaugeValueUnit

Göstergenin modelinin değer birimi.
quality_verified

bool

Bu modelin kalite açısından doğrulanıp doğrulanmadığı. Bu değer yanlış olarak ayarlandığında lütfen dikkatli kullanın.

GaugeValueUnit

Olası gösterge değeri birimleri.

Sıralamalar
GAUGE_VALUE_UNIT_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
METERS Metre.
CUBIC_METERS_PER_SECOND Saniyede metreküp.

GetGaugeModelRequest

GetGaugeModel isteği.

Alanlar
name

string

Zorunlu. Alınacak ölçüm cihazı modelinin adı. Ad biçimi: gaugeModels/{gauge_id}.

GetGaugeRequest

GetGauge'un isteği.

Alanlar
name

string

Zorunlu. Alınacak ölçümün adı. Ad biçimi: gauges/{gauge_id}.

GetSerializedPolygonRequest

GetSerializedPolygon isteği.

Alanlar
name

string

Zorunlu. Alınacak serileştirilmiş poligonun adı. Ad biçimi: serializedPolygons/{polygon_id}

Döngü

Haritada bir döngü. Basit bir küresel poligonu temsil eder. İlk köşenin son köşeye örtülü olarak bağlı olduğu tek bir köşe zincirinden oluşur.

Alanlar
vertices[]

LatLng

Zorunlu. Döngünün köşeleri.

QueryGaugeForecastsRequest

QueryGaugeForecasts isteği.

Alanlar
gauge_ids[]

string

Zorunlu. Ölçüm cihazı kimliklerinin listesi. Desteklenen liste boyutu 500 ile sınırlıdır. 500'den büyük bir liste sağlanırsa INVALID_REQUEST hatasıyla başarısız olur.
issued_time_start

string

İsteğe bağlı. Dize olarak verilen en erken tahmin yayınlanma zamanı (ISO 8601), ör. "2023-06-17T10:34:00Z" veya tarih dizesi, ör. "2023-10-13". Başlangıç zamanı "2023-10-01" tarihinden önce olamaz. Varsayılan değer bir hafta öncesidir.
issued_time_end

string

İsteğe bağlı. Dize olarak verilen en son tahmin yayınlanma zamanı (ISO 8601), ör. "2023-06-17T10:34:00Z" veya tarih dizesi, ör. "2023-10-13". Varsayılan değer "şimdi"dir.

QueryGaugeForecastsResponse

QueryGaugeForecasts'in yanıtı.

Alanlar
forecasts

map<string, ForecastSet>

Ölçüm cihazı kimliğinden tahmin kümesine giden bir harita.

QueryLatestFloodStatusByGaugeIdsRequest

QueryLatestFloodStatusByGaugeIds isteği.

Alanlar
gauge_ids[]

string

Zorunlu. Ölçüm cihazı kimliklerinin listesi. Desteklenen liste boyutu 20.000 ile sınırlıdır. 20.000'den büyük bir liste sağlanırsa INVALID_REQUEST hatasıyla başarısız olur.

QueryLatestFloodStatusByGaugeIdsResponse

QueryLatestFloodStatusByGaugeIds'nin yanıtı.

Alanlar
flood_statuses[]

FloodStatus

İstenen ölçüm cihazlarının en son sel durumları.

SearchGaugesByAreaRequest

SearchGaugesByArea isteği.

Alanlar
page_size

int32

İsteğe bağlı. Döndürülecek maksimum gösterge sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemişse en fazla 50.000 gösterge döndürülür. Maksimum değer 50.000'dir. 50.000'in üzerindeki değerler 50.000'e zorlanır.
page_token

string

İsteğe bağlı. Önceki bir SearchGauges çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi yapılırken SearchGauges öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

Birleştirme alanı search_by.

search_by yalnızca aşağıdakilerden biri olabilir:
region_code

string

Bölge koduna göre bir bölgedeki tüm göstergeleri arayın. https://cldr.unicode.org/ adresini kullanın (https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry) adresini listeleyin).
loop

Loop

Bir döngüdeki tüm göstergeleri arayın (basit bir küresel poligon, bkz. Loop).
include_non_quality_verified

bool

İsteğe bağlı. Kalitesi doğrulanmamış sonuç göstergelerini dahil edin. Lütfen dikkatli kullanın. Varsayılan değer yanlış (false) değeridir.
include_gauges_without_hydro_model

bool

İsteğe bağlı. Google'ın kendi bünyesinde hidro modeli olmayan sonuç göstergelerini dahil edin. Varsayılan değer yanlış (false) değeridir.

SearchGaugesByAreaResponse

SearchGaugesByArea'nın yanıtı.

Alanlar
gauges[]

Gauge

İstenen alanda bulunan ölçüm cihazları.
next_page_token

string

İsteğe bağlı. Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

SearchLatestFloodStatusByAreaRequest

SearchLatestFloodStatusByArea isteği.

Alanlar
page_token

string

İsteğe bağlı. Önceki bir SearchLatestFloodStatusByArea çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi yapılırken SearchLatestFloodStatusByArea öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
page_size

int32

İsteğe bağlı. Döndürülecek maksimum sel durumu sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 20.000 sel durumu döndürülür. Maksimum değer 20.000'dir. 20.000'in üzerindeki değerler 20.000'e zorlanır.

Birleştirme alanı area_type.

area_type yalnızca aşağıdakilerden biri olabilir:
region_code

string

Sel durumlarının sorgulanacağı bölge. CLDR'yi kullanma (ör. "US".
loop

Loop

Sel durumlarının sorgulanacağı döngü.
include_non_quality_verified

bool

İsteğe bağlı. Kalitesi doğrulanmamış sonuç göstergelerini dahil edin. Lütfen dikkatli kullanın. Varsayılan değer yanlış (false) değeridir.

SearchLatestFloodStatusByAreaResponse

SearchLatestFloodStatusByArea'nın yanıtı.

Alanlar
flood_statuses[]

FloodStatus

İstenen bölgedeki en son sel durumları. Şu anda bu durum, göstergelerin konumuna göre belirlenir ve gelecekte değişebilir.
next_page_token

string

İsteğe bağlı. Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

SerializedPolygon

Serileştirilmiş bir poligon.

Alanlar
polygon_id

string

Poligonun kimliği.
kml

string

Poligonun KML dize gösterimi.

Eşikler

Bir göstergenin modelinin eşikleri.

Alanlar
warning_level

double

Uyarı seviyesi.
danger_level

double

Tehlike seviyesi.
extreme_danger_level

double

Olağanüstü tehlike seviyesi. Her zaman mevcut değildir.

TimeRange

Zaman aralığı.

Alanlar
start

string

Zaman aralığının başlangıcı. ISO 8601 olarak gösterilir. Örneğin: "2023-06-17T10:34:00Z".
end

string

Zaman aralığının sonu. ISO 8601 olarak gösterilir. Örneğin: "2023-06-17T10:34:00Z".