Migration der Bing Maps Find Time Zone API

In diesem Artikel wird erläutert, wie Sie von der Bing Maps Find Time Zone API zur Azure Maps Get Timezone By Coordinates API migrieren. Die Azure Maps Get Timezone By Coordinates-API gibt aktuelle, historische und zukünftige Zeitzoneninformationen für ein angegebenes Breitengrad-Längengrad-Paar sowie Sonnenuntergangs- und Sonnenaufgangszeiten für einen bestimmten Ort zurück.

Voraussetzungen

Wichtige Unterschiede

  • Bing Maps Find Time Zone API unterstützt Koordinaten und Ortsplatznamen, Administrative Region und Land/Region-Name als Standorteingabe. Azure Maps Get Timezone By Coordinates API unterstützt nur Koordinaten. Um die Koordinaten für Standortplatzname, administrative Region und Land/Region-Name abzurufen, können Sie die Azure Maps Get Geocoding-API verwenden.
  • Bing Maps Find Time Zone API unterstützt sowohl XML- als auch JSON-Antwortformate, Azure Maps Get Timezone By Coordinates API unterstützt nur JSON.
  • Bing Maps Find Time Zone API bietet keine Sonnenaufgangs- und Sonnenuntergangswerte für eine bestimmte Zeitzone, die Azure Maps Get Time Zone by Coordinates API hingegen schon.
  • Im Gegensatz zu Bing Maps for Enterprise ist Azure Maps ein globaler Dienst, der die Angabe eines geografischen Bereichs unterstützt, mit dem Sie die Datenaufbewahrung auf die europäischen (EU) oder usa (USA) geografischen Gebiete (Geos) beschränken können. Alle Anforderungen (einschließlich Eingabedaten) werden ausschließlich im angegebenen geografischen Bereich verarbeitet. Weitere Informationen finden Sie im geografischen Bereich des Azure Maps-Diensts.

Sicherheit und Authentifizierung

Bing Maps for Enterprise unterstützt nur die API-Schlüsselauthentifizierung. Azure Maps unterstützt mehrere Möglichkeiten zum Authentifizieren Ihrer API-Aufrufe, z. B. eines Abonnementschlüssels, einer Microsoft Entra-ID oder eines SAS-Tokens (Shared Access Signature). Weitere Informationen zur Sicherheit und Authentifizierung in Azure Maps finden Sie im Abschnitt "Authentifizierung mit Azure Maps " und im Abschnitt "Sicherheit " in der Dokumentation "Azure Maps Get Time Zone By Coordinates".

Anforderungsparameter

In der folgenden Tabelle sind die Parameter " Zeitzonensuche" von Bing Maps und die Azure Maps-Entsprechung aufgeführt:

Bing Maps-Parameter Bing Maps-Parameteralias Azure Maps-Parameter Erforderlich in Azure Maps Azure Maps-Datentyp Beschreibung
Datum und Uhrzeit Dt Zeitstempel Falsch string Datum/Uhrzeit Alternativ können Sie den Alias "stamp" oder "s" verwenden. Referenzzeit, wenn diese nicht angegeben wird, verwendet die API die Computerzeit für die Anforderung.
IncludeDstRules Nichts transitionsFrom Falsch string Datum/Uhrzeit Das Startdatum, ab dem Sommerzeitübergänge (DST) angefordert werden, gilt nur, wenn „options“ = all or „options“ = transitions. Weitere Informationen finden Sie unter options (Timezone Options)-Parameter.  
Ausgabe o format Richtig JSONFormat In dieser Azure Maps-API wird nur das JSON-Format unterstützt.
point Nichts Abfrage Richtig number Koordinaten des Punkts, an dem Zeitzoneninformationen angefordert werden. Dieser Parameter ist eine Liste der Koordinaten, die ein Koordinatenpaar (lat, long) enthalten. Wenn dieser Endpunkt direkt aufgerufen wird, werden Koordinaten als einzelne Zeichenfolge übergeben, die Koordinaten enthält, getrennt durch Kommas.
Anfrage q Nicht unterstützt Nicht unterstützt Nicht unterstützt Nur Koordinaten des Punkts, an dem Zeitzoneninformationen angefordert werden, werden unterstützt. Standorttypen wie Adresse, Lokalität, Postleitzahl usw. werden nicht unterstützt. Um die Koordinaten für Standortplatzname, administrative Region und Land/Region-Name abzurufen, können Sie die Azure Maps Get Geocoding-API verwenden.

Weitere Informationen finden Sie unter den Azure Maps Get Timezone By Coordinates URI-Parametern.

Beispiele anfordern

Bing Maps- API-Anforderung "Zeitzonensuche ":

https://dev.virtualearth.net/REST/v1/timezone/37.7800,-122.4201?key=%7bBingMapsKey%7d

Azure Maps Zeitzone nach Koordinaten abrufen API-Anfrage:

https://atlas.microsoft.com/timezone/byCoordinates/json?api-version=1.0&query=37.7800,-122.4201&subscription-key={Your-Azure-Maps-Subscription-key}

Antwortfelder

In der folgenden Tabelle sind die Felder aufgeführt, die in der HTTP-Antwort angezeigt werden können, wenn die Bing Maps Find Time Zone API und die Azure Maps-Entsprechung ausgeführt werden:

Bing Maps-Antwortfeld Antwortfeld "Azure Maps"
Abkürzung (JSON)
Abkürzung (XML) 		ReferenceTime (Tag)
convertedTime (JSON)
ConvertedTime (XML) 		ReferenceTime (WallTime)
dstRule (JSON)
DSTRule (XML) 		TimeTransitions
genericName (JSON)
GenericName (XML) 		Zeitzonennamen
ianaTimeZoneId (JSON)
IANATimeZoneID (XML)		 ID
utcOffset (JSON)
UTCOffset (XML) 		ReferenceTime (StandardOffset)
windowsTimeZoneID (JSON)
WindowsTimeZoneID (XML)		 Nicht unterstützt. Verwenden Sie azure Maps Get Timezone Enum Windows API, um in die Windows-Zeitzone zu konvertieren.

Weitere Informationen zu den Antwortfeldern "Azure Maps Get Timezone By Coordinates" finden Sie in den Antwortdefinitionen.

Beispielantworten

Der folgende JSON-Code zeigt ein Beispiel dafür, was im Textkörper der HTTP-Antwort zurückgegeben wird, wenn die Bing Maps Find Time Zone API-Anforderung ausgeführt wird:

{
    "authenticationResultCode": "ValidCredentials",
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
    "resourceSets": [
        {
            "estimatedTotal": 1,
            "resources": [
                {
                    "__type": "RESTTimeZone:http://schemas.microsoft.com/search/local/ws/rest/v1",
                    "timeZone": {
                        "genericName": "Pacific Standard Time",
                        "abbreviation": "PST",
                        "ianaTimeZoneId": "America/Los_Angeles",
                        "windowsTimeZoneId": "Pacific Standard Time",
                        "utcOffset": "-8:00",
                        "convertedTime": {
                            "localTime": "2024-02-11T14:21:58",
                            "utcOffsetWithDst": "-8:00",
                            "timeZoneDisplayName": "Pacific Standard Time",
                            "timeZoneDisplayAbbr": "PST"
                        }
                    }
                }
            ]
        }
    ],
    "statusCode": 200,
    "statusDescription": "OK",
    "traceId": "f02637665942c8cb21c8414bd03224aa|MWH0032BEF|0.0.0.1"
}

Das folgende Beispiel zeigt, was im Textkörper der HTTP-Antwort zurückgegeben wird, wenn eine Azure Maps Get Time Zone by Coordinates-API-Anforderung ausgeführt wird:

{
    "Version": "2023d",
    "ReferenceUtcTimestamp": "2024-02-11T22:32:29.4282815Z",
    "TimeZones": [
        {
            "Id": "America/Los_Angeles",
            "Aliases": [
                "US/Pacific"
            ],
            "Countries": [
                {
                    "Name": "United States",
                    "Code": "US"
                }
            ],
            "Names": {
                "ISO6391LanguageCode": "en",
                "Generic": "Pacific Time",
                "Standard": "Pacific Standard Time",
                "Daylight": "Pacific Daylight Time"
            },
            "ReferenceTime": {
                "Tag": "PST",
                "StandardOffset": "-08:00:00",
                "DaylightSavings": "00:00:00",
                "WallTime": "2024-02-11T14:32:29.4282815-08:00",
                "PosixTzValidYear": 2024,
                "PosixTz": "PST+8PDT,M3.2.0,M11.1.0",
                "Sunrise": "2024-02-11T07:04:33.6950704-08:00",
                "Sunset": "2024-02-11T17:43:15.3679015-08:00"
            },
            "RepresentativePoint": {
                "Latitude": 34.05222222222222,
                "Longitude": -118.24277777777777
            },
            "TimeTransitions": [
                {
                    "Tag": "PST",
                    "StandardOffset": "-08:00:00",
                    "DaylightSavings": "00:00:00",
                    "UtcStart": "2023-11-05T09:00:00Z",
                    "UtcEnd": "2024-03-10T10:00:00Z"
                },
                {
                    "Tag": "PDT",
                    "StandardOffset": "-08:00:00",
                    "DaylightSavings": "01:00:00",
                    "UtcStart": "2024-03-10T10:00:00Z",
                    "UtcEnd": "2024-11-03T09:00:00Z"
                },
                {
                    "Tag": "PST",
                    "StandardOffset": "-08:00:00",
                    "DaylightSavings": "00:00:00",
                    "UtcStart": "2024-11-03T09:00:00Z",
                    "UtcEnd": "2025-03-09T10:00:00Z"
                }
            ]
        }
    ]
}

Transaktionsnutzung

Ähnlich wie die Bing Maps for Enterprise Find-Zeitzonen-API protokolliert die Azure Maps Get Timezone By Coordinates API eine abrechnende Transaktion pro API-Anforderung. Weitere Informationen zu Azure Maps-Transaktionen finden Sie unter Grundlegendes zu Azure Maps-Transaktionen.

Zusatzinformation

Weitere Azure Maps-Zeitzonen-APIs

Support

  • Last updated on