Weather - Get Daily Historical Actuals

Referenz

Dienst:: Maps

API-Version:: 1.1

Verwenden Sie diese Option, um Klimatologiedaten wie vergangene täglich tatsächlich beobachtete Temperaturen, Niederschlag, Schneefall und Schneehöhe zu erhalten.

Bei der Get Daily Historical Actuals API handelt es sich um eine HTTP-Anforderung GET , die Klimatologiedaten wie vergangene täglich tatsächlich beobachtete Temperaturen, Niederschlag, Schneefall, Schneehöhe und Informationen zum Kühl-/Heizgrad für den Tag an einem bestimmten Koordinatenort zurückgibt. Die Daten werden für einen bestimmten Zeitraum von bis zu 31 Tagen in einer einzigen API-Anfrage angefordert. Im Allgemeinen können historische Daten je nach Standort bis zu den letzten 5 bis 40+ Jahren verfügbar sein.

GET https://atlas.microsoft.com/weather/historical/actuals/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}

Mit optionalen Parametern:

GET https://atlas.microsoft.com/weather/historical/actuals/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}&unit={unit}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
format	path	True	JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
api-version	query	True	string	Versionsnummer der Azure Maps-API.
endDate	query	True	string (date)	Enddatum im ISO 8601-Format, z. B. 28.10.2019. Der unterstützte Datumsbereich liegt zwischen 1 und 31 Kalendertagen, daher stellen Sie sicher, dass Sie ein startDate und endDate angeben, das einen Höchstwert von 31 Tagen nicht überschreitet (z. B.: startDate=2012-01-01&endDate=2012-01-31).
query	query	True	number[]	Die entsprechende Abfrage, die als kommagetrennte Zeichenfolge angegeben wird, die durch Breitengrad und Längengrad besteht, z. B. "47.641268,-122.125679". Wetterinformationen sind in der Regel für Orte an Land, von Land umgebene Gewässer und Bereiche des Ozeans verfügbar, die sich innerhalb von etwa 50 Seemeilen um eine Küste befinden.
startDate	query	True	string (date)	Startdatum im ISO 8601-Format, z. B. 27.10.2019. Der unterstützte Datumsbereich liegt zwischen 1 und 31 Kalendertagen, daher stellen Sie sicher, dass Sie ein startDate und endDate angeben, das einen Höchstwert von 31 Tagen nicht überschreitet (z. B.: startDate=2012-01-01&endDate=2012-01-31).
unit	query		WeatherDataUnit	Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt an, welches Konto in Verbindung mit dem Microsoft Entra ID-Sicherheitsmodell für die Verwendung vorgesehen ist. Sie stellt eine eindeutige ID für das Azure Maps-Konto dar und kann aus der Azure Maps-Verwaltungsebenen-Konto-API abgerufen werden. Informationen zur Verwendung der Sicherheit von Microsoft Entra-ID in Azure Maps finden Sie in den folgenden Artikeln anleitungen.

Antworten

Name	Typ	Beschreibung
200 OK	DailyHistoricalActualsResult	OKAY
Other Status Codes	ErrorResponse	Ein unerwarteter Fehler ist aufgetreten.

Sicherheit

AADToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. Bei Kombination mit rollenbasierten Azure-Zugriff Steuern kann es verwendet werden, um den Zugriff auf Azure Maps-REST-APIs zu steuern. Azure-rollenbasierte Zugriffssteuerungen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jedem Benutzer, Gruppen- oder Dienstprinzipal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht, Zugriff gewährt werden.

Um Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepteanzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte, die zugriffsfähig für bestimmte APIs und Bereiche sind.

Hinweise

Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id-Headers, um anzugeben, auf welche Azure Maps-Ressource die Anwendung Zugriff anfordert. Dies kann über die Kartenverwaltung API erworben werden.

Die Authorization URL ist spezifisch für die Öffentliche Azure-Cloudinstanz. Souveräne Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra-ID-Konfigurationen. * Die rollenbasierte Azure-Zugriffssteuerung wird über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert. * Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

Weitere Informationen zur Microsoft Identity Platform finden Sie unter Übersicht über die Microsoft Identity Platform.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

subscription-key

Dies ist ein freigegebener Schlüssel, der bereitgestellt wird, wenn Sie Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API.

Mit diesem Schlüssel kann jede Anwendung auf alle REST-API zugreifen. Mit anderen Worten, dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, die vertraulichen Clientanwendungen Ansatz für den Zugriff auf Azure Maps-REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: query

SAS Token

Dies ist ein Freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und feinkörniger Kontrolle auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token autorisiert. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen das Steuern des Zugriffs auf eine sicherere Weise zu ermöglichen als der freigegebene Schlüssel.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge auf der Zuordnungskontoressource zu konfigurieren,, um das Rendern von Missbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Successful Daily Historical Actuals Request

Beispielanforderung

HTTP

GET https://atlas.microsoft.com/weather/historical/actuals/daily/json?api-version=1.1&query=40.78,-77.89&startDate=2012-01-20&endDate=2012-01-22

Beispiel für eine Antwort

Statuscode:: 200

{
  "results": [
    {
      "date": "2012-01-20T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": -6.1,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -11.1,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": -8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 27,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 10.9,
        "unit": "mm",
        "unitType": 3
      },
      "snowfall": {
        "value": 12.19,
        "unit": "cm",
        "unitType": 4
      },
      "snowDepth": {
        "value": 15.2,
        "unit": "cm",
        "unitType": 4
      }
    },
    {
      "date": "2012-01-21T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": -1.7,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -8.9,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": -5.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 24,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snowfall": {
        "value": 0.51,
        "unit": "cm",
        "unitType": 4
      },
      "snowDepth": {
        "value": 12.7,
        "unit": "cm",
        "unitType": 4
      }
    },
    {
      "date": "2012-01-22T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -7.2,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": -3.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 22,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snowfall": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "snowDepth": {
        "value": 10.2,
        "unit": "cm",
        "unitType": 4
      }
    }
  ]
}

Definitionen

Name	Beschreibung
DailyHistoricalActuals
DailyHistoricalActualsResult
DegreeDaySummary
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
UnitType	Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .
WeatherDataUnit	Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.
WeatherUnit	Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.
WeatherUnitMaxMinAvg	Zurückgegebene Temperaturwerte.

DailyHistoricalActuals

Objekt

Name	Typ	Beschreibung
date	string (date-time)	Datum und Uhrzeit der aktuellen Beobachtung werden im ISO 8601-Format angezeigt, z. B. 2019-10-27T19:39:57-08:00.
degreeDaySummary	DegreeDaySummary	Zusammenfassung der Informationen zum Heiz- oder Kühlgradtag. Gradtage sind ein Maß dafür, wie kalt oder warm ein Ort ist. Ein Gradtag vergleicht den Mittelwert (den Durchschnitt der hohen und niedrigen) Außentemperaturen, die für einen Ort aufgezeichnet wurden, mit einer Standardtemperatur von 65 Grad F / 18 Grad C.
precipitation	WeatherUnit	Die Niederschlagsmenge (flüssiges Äquivalent), die gefallen ist.
snowDepth	WeatherUnit	Schneehöhe.
snowfall	WeatherUnit	Die Menge an Schnee, die gefallen ist.
temperature	WeatherUnitMaxMinAvg	Temperaturwerte.

DailyHistoricalActualsResult

Objekt

Name	Typ	Beschreibung
nextLink	string	Dies ist der Link zur nächsten Seite der zurückgegebenen Features. Wenn es sich um die letzte Seite handelt, ist dieses Feld nicht vorhanden.
results	DailyHistoricalActuals[]	Historische Ist-Werte für jeden angeforderten Tag.

DegreeDaySummary

Objekt

Name	Typ	Beschreibung
cooling	WeatherUnit	Anzahl der Grad, bei denen die mittlere Temperatur über 65 Grad F / 18 Grad C liegt.
heating	WeatherUnit	Anzahl der Grad, bei denen die Durchschnittstemperatur unter 65 Grad F / 18 Grad C liegt.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

JsonFormat

Enumeration

Gewünschtes Format der Antwort. Nur json Format wird unterstützt.

Wert	Beschreibung
json	das JavaScript Object Notation Data Interchange Format

UnitType

Enumeration

Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .

Wert	Beschreibung
0	Fuß
1	Zoll
10	Meterpro Sekunde
11	hektoPascal
12	ZollOfMercury
13	kiloPascal
14	Millibar
15	MillimeterVonQuecksilber
16	Pfundpro Quadratzoll
17	Celsius
18	Fahrenheit
19	Kelvin
2	Meilen
20	Prozent
21	Schweben
22	Integer
3	Millimeter
31	MikrogrammPerCubicMeterOfAir
4	Zentimeter
5	Meter
6	Kilometer
7	Kilometer/Stunde
8	Knoten
9	Meilenpro Stunde

WeatherDataUnit

Enumeration

Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.

Wert	Beschreibung
imperial	Geben Sie Daten in imperialen Einheiten zurück. Einige Beispiele für Einheiten des imperialen Systems sind Fahrenheit und Mile.
metric	Gibt Daten in metrischen Einheiten zurück. Einige Beispieleinheiten für das metrische System sind Celsius und Kilometer.

WeatherUnit

Objekt

Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.

Name	Typ	Beschreibung
unit	string	Typ der Einheit für den zurückgegebenen Wert.
unitType	UnitType (int32)	Numerischer ID-Wert, der dem Typ der angezeigten Einheit zugeordnet ist. Kann für die Einheitenumrechnung verwendet werden. Weitere Informationen finden Sie unter Wetterdienste in Azure Maps .
value	number (float)	Gerundeter Wert.

WeatherUnitMaxMinAvg

Objekt

Zurückgegebene Temperaturwerte.

Name	Typ	Beschreibung
average	WeatherUnit	Durchschnittliche Temperatur für den Zeitraum.
maximum	WeatherUnit	Maximale Temperatur für den Zeitraum.
minimum	WeatherUnit	Minimale Temperatur für den Zeitraum.

Freigeben über

Weather - Get Daily Historical Actuals

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

AADToken

Hinweise

Bereiche

subscription-key

SAS Token

Beispiele

Successful Daily Historical Actuals Request

Beispielanforderung

Beispiel für eine Antwort

Definitionen

DailyHistoricalActuals

DailyHistoricalActualsResult

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

JsonFormat

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitMaxMinAvg