Weather - Get Minute Forecast

Başvuru

Hizmet:: Maps

API Sürümü:: 1.1

1, 5 ve 15 dakikalık aralıklarla sonraki 120 dakika için dakika dakika tahminini almak için kullanın.

Get Minute Forecast API, sonraki 120 dakika boyunca belirli bir konum için dakika dakika tahminleri döndüren bir HTTP GET isteğidir. Kullanıcılar 1, 5 ve 15 dakikalık aralıklarla hava durumu tahminleri isteyebilir. Yanıtta yağış türü (yağmur, kar veya her ikisinin karışımı dahil), başlangıç saati ve yağış yoğunluğu değeri (dBZ) gibi ayrıntılar yer alır. Daha fazla bilgi için bkz. Dakika dakika hava durumu tahmini verileri isteme.

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}

İsteğe bağlı parametrelerle:

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
format	path	True	JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
api-version	query	True	string	Azure Haritalar API'sinin sürüm numarası.
query	query	True	number[]	Enlem ve ardından boylam tarafından oluşturulan virgülle ayrılmış bir dize olarak belirtilen ilgili sorgu; örneğin, "47.641268,-122.125679".
interval	query		integer	Döndürülen hava durumu tahmini için dakika cinsinden zaman aralığını belirtir. Desteklenen değerler şunlardır: `1` - 1 dakikalık aralıklar için tahmini alın. Varsayılan olarak döndürülür. `5` - 5 dakikalık aralıklar için tahminleri alın. `15` - 15 dakikalık aralıklar için tahminleri alın.
language	query		string	Arama sonuçlarının döndürülmesi gereken dil. Büyük/küçük harfe duyarsız, desteklenen IETF dil etiketlerinden biri olmalıdır. Belirtilen dildeki veriler belirli bir alan için kullanılabilir olmadığında, varsayılan dil kullanılır. Ayrıntılar için lütfen Desteklenen Diller'e bakın.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Microsoft Entra ID güvenlik modeliyle birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın.

Yanıtlar

Name	Tür	Description
200 OK	MinuteForecastResult	Tamam
Other Status Codes	ErrorResponse	Beklenmeyen bir hata oluştu.

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişimi belirtmek için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak için kimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemeye yönelik bir çözüm sağlar.

Notlar

Bu güvenlik tanımı, uygulamanın erişim isteğinde x-ms-client-id bulunduğu Azure Haritalar kaynağını belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir.

Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır. * Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır. * Azure Haritalar Web SDK'sının kullanımı, birden çok kullanım örneği için bir uygulamanın yapılandırma tabanlı kurulumuna olanak tanır.

Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Bu, Azure portalında Azure Haritalar hesabı oluşturduğunuzda veya PowerShell, CLI, Azure SDK'ları veya REST API kullandığınızda sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi öneririz.

Tür: apiKey
İçinde: query

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure Haritalar kaynağındaki Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, uygunsuz işlemeyi sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmanızdır.

Tür: apiKey
İçinde: header

Örnekler

Successfully retrieve minute-by-minute forecasts for a given location

Örnek isteği

HTTP

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

Örnek yanıt

Durum kodu:: 200

{
  "summary": {
    "briefPhrase60": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min",
    "briefPhrase": "Rain ending in 25 min",
    "longPhrase": "Rain ending in 25 min",
    "iconCode": 12
  },
  "intervalSummaries": [
    {
      "startMinute": 0,
      "endMinute": 24,
      "totalMinutes": 25,
      "shortPhrase": "Rain ending in %minute_value min",
      "briefPhrase": "Rain ending in %minute_value min",
      "longPhrase": "Rain ending in %minute_value min",
      "iconCode": 12
    },
    {
      "startMinute": 25,
      "endMinute": 119,
      "totalMinutes": 95,
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "iconCode": 7
    }
  ],
  "intervals": [
    {
      "startTime": "2019-11-14T15:18:00-08:00",
      "minute": 0,
      "dbz": 23,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 8,
        "green": 98,
        "blue": 2,
        "hex": "#086202"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:33:00-08:00",
      "minute": 15,
      "dbz": 18,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 32,
        "green": 133,
        "blue": 9,
        "hex": "#208509"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:48:00-08:00",
      "minute": 30,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:03:00-08:00",
      "minute": 45,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:18:00-08:00",
      "minute": 60,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:33:00-08:00",
      "minute": 75,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:48:00-08:00",
      "minute": 90,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T17:03:00-08:00",
      "minute": 105,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    }
  ]
}

Tanımlar

Name	Description
ColorValue
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ForecastInterval
IconCode	öğesini görüntüleyen bir görüntüyü temsil eden `iconPhrase`sayısal değer. Ayrıntılar için lütfen Azure Haritalar'daki Hava durumu hizmetlerine bakın.
IntervalSummary
JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
MinuteForecastResult
MinuteForecastSummary	Tüm tahmin dönemi için tümcecik özetleri.
PrecipitationType	Yağış türünü ("Rain" "Snow" "Ice" veya "Mix") belirtir. dbz sıfırsa, yanıtta precipitationType yok.

ColorValue

Name	Tür	Description
blue	integer	RGB değerinin mavi bileşeni
green	integer	RGB değerinin yeşil bileşeni.
hex	string	Onaltılık renk değeri.
red	integer	RGB değerinin kırmızı bileşeni.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ForecastInterval

Name	Tür	Description
cloudCover	integer	Bulut kapağını temsil eden yüzde.
color	ColorValue	dBZ ile eşlenen tam spektrum rengi (Z'ye göre desibel). dbz sıfırsa, yanıtta renk yok.
dbz	number	Tahmin edilen yağış yoğunluğunu temsil eden birim.
iconCode	IconCode	öğesini görüntüleyen bir görüntüyü temsil eden `iconPhrase`sayısal değer. Ayrıntılar için lütfen Azure Haritalar'daki Hava durumu hizmetlerine bakın.
minute	integer	Aralığın ilk dakikası.
precipitationType	PrecipitationType	Yağış türünü ("Rain" "Snow" "Ice" veya "Mix") belirtir. dbz sıfırsa, yanıtta precipitationType yok.
shortPhrase	string	Aralık için yağış durumunu açıklayan kısa bir ifade.
simplifiedColor	ColorValue	Yağış türüne ve eşiğine eşleyen bant rengi. dbz sıfırsa, yanıtta yok.
startTime	string	Iso 8601 biçimindeki aralığın başlangıcı için tarih ve saat; örneğin, 2019-10-27T19:39:57-08:00.
threshold	string	Eşik değerini belirten anahtar. BasitleştirilmişColor'ı belirlemek için precipitationType ile birlikte kullanılabilir. dbz sıfırsa, yanıtta yok.

IconCode

öğesini görüntüleyen bir görüntüyü temsil eden iconPhrasesayısal değer. Ayrıntılar için lütfen Azure Haritalar'daki Hava durumu hizmetlerine bakın.

Name	Tür	Description
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

IntervalSummary

Name	Tür	Description
briefPhrase	string	Kısa özet tümcecik. Tümcecik uzunluğu yaklaşık 60 karakterdir.
endMinute	integer	Özetin geçerli olduğu son dakika.
iconCode	IconCode	öğesini görüntüleyen bir görüntüyü temsil eden `iconPhrase`sayısal değer. Ayrıntılar için lütfen Azure Haritalar'daki Hava durumu hizmetlerine bakın.
longPhrase	string	Uzun özet tümcecik. Tümcecik uzunluğu 60'ın üzeri karakterdir.
shortPhrase	string	Kısa özet tümcecik. Tümcecik uzunluğu yaklaşık 25 karakterdir.
startMinute	integer	Özetin uygulandığı ilk dakika.
totalMinutes	integer	Özetin geçerli olduğu dakika sayısı.

JsonFormat

Yanıtın istenen biçimi. Yalnızca json biçim desteklenir.

Name	Tür	Description
json	string	JavaScript Nesne Gösterimi Veri Değişim Biçimi

MinuteForecastResult

Name	Tür	Description
intervalSummaries	IntervalSummary[]	Tahmindeki her aralığın özet bilgileri. Özetler, yağışın başladığı ve durduğu her olası aralığı ayırır.
intervals	ForecastInterval[]	Tahmindeki her aralık için tahmin verileri.
summary	MinuteForecastSummary	Tüm tahmin dönemi için tümcecik özetleri.

MinuteForecastSummary

Tüm tahmin dönemi için tümcecik özetleri.

Name	Tür	Description
briefPhrase	string	Sonraki 120 dakika için özet tümcecik. Tümcecik uzunluğu yaklaşık 60 karakterdir.
briefPhrase60	string	Sonraki 60 dakika için özet tümcecik. Tümcecik uzunluğu yaklaşık 60 karakterdir.
iconCode	IconCode	öğesini görüntüleyen bir görüntüyü temsil eden `iconPhrase`sayısal değer. Ayrıntılar için lütfen Azure Haritalar'daki Hava durumu hizmetlerine bakın.
longPhrase	string	Sonraki 120 dakika için uzun özet tümcecik. Tümcecik uzunluğu 60'ın üzeri karakterdir.
shortPhrase	string	Sonraki 120 dakika için kısa özet tümcecik. Tümcecik uzunluğu yaklaşık 25 karakterdir.

PrecipitationType

Yağış türünü ("Rain" "Snow" "Ice" veya "Mix") belirtir. dbz sıfırsa, yanıtta precipitationType yok.

Name	Tür	Description
Ice	string	Ice
Mix	string	Karışık
Rain	string	Yağmur
Snow	string	Kar

Aracılığıyla paylaş