Freigeben über

Migrieren 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

  • Die Bing Maps Find Time Zone-API unterstützt Koordinaten und den Namen des Ortes, die Verwaltungsregion und den Namen des Landes/der Region als Standorteingabe. Die Azure Maps Get Timezone By Coordinates-API unterstützt nur Koordinaten. Um die Koordinaten für den Namen eines Ortes, die Verwaltungsregion und den Namen des Landes/der Region abzurufen, können Sie die Azure Maps Get Geocoding-API verwenden.
  • Die Bing Maps Find Time Zone-API unterstützt sowohl XML- als auch JSON-Antwortformate, die Azure Maps Get Timezone By Coordinates-API unterstützt nur JSON.
  • Die Bing Maps Find Time Zone-API bietet keine Angaben zu Sonnenauf- und Sonnenuntergang für eine bestimmte Zeitzone, die Azure Maps Get Time Zone by Coordinates-API 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 Datenresidenz auf die geografischen Bereiche (Geografien) „Europa“ (EU) oder „USA“ (US) beschränken können. Alle Anforderungen (einschließlich Eingabedaten) werden ausschließlich im angegebenen geografischen Bereich verarbeitet. Weitere Informationen finden Sie unter Geografischer Bereich des Azure Maps-Dienstes.

Sicherheit und Authentifizierung

Bing Maps for Enterprise unterstützt nur die Authentifizierung mit einem API-Schlüssel. Azure Maps unterstützt mehrere Möglichkeiten für die Authentifizierung Ihrer API-Aufrufe, z. B. Abonnementschlüssel, Microsoft Entra ID oder SAS-Tokens (Shared Access Signature). Weitere Informationen zur Sicherheit und Authentifizierung in Azure Maps finden Sie unter Authentifizierung mit Azure Maps und im Abschnitt „Sicherheit“ in der Dokumentation zur Azure Maps Get Time Zone By Coordinates-API.

Anforderungsparameter

In der folgenden Tabelle sind die Bing Maps Find Time Zone-Anforderungsparameter und die Azure Maps-Entsprechung aufgeführt:

Bing Maps-Parameter Bing Maps-Parameteralias Azure Maps Parameter Erforderlich in Azure Maps Azure Maps-Datentyp Beschreibung
dateTime dt timeStamp False string Datum/Uhrzeit Alternativ können Sie das Alias „stamp“ oder „s“ verwenden. Wenn dies nicht angegeben wird, verwendet die API die Computerzeit für die Anforderung.
IncludeDstRules Keine transitionsFrom False 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 Optionen)-Parameter.  
output o format True JSONFormat In dieser Azure Maps-API wird nur das JSON-Format unterstützt.
Punkt Keine query True Zahl 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 die Koordinaten als eine einzige Zeichenkette mit Koordinaten, getrennt durch Kommas, übergeben.
query q Nicht unterstützt Nicht unterstützt Nicht unterstützt Es werden nur Koordinaten des Punkts unterstützt, an dem Zeitzoneninformationen angefordert werden. Standorttypen wie Adresse, Lokalität, Postleitzahl usw. werden nicht unterstützt. Um die Koordinaten für den Namen eines Ortes, die Verwaltungsregion und den Namen des Landes/der Region 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 für Anforderungen

Bing Maps Find Time Zone-API-Anforderung:

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

Azure Maps Get Time Zone by Coordinates API-Anforderung:

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 Sie die Bing Maps Find Time Zone-API und ihre Azure Maps-Entsprechung ausführen:

Bing Maps-Antwortfeld Azure Maps Antwortfeld
abbreviation (JSON)
Abbreviation (XML) 		ReferenceTime (Tag)
convertedTime (JSON)
ConvertedTime (XML) 		ReferenceTime (WallTime)
dstRule (JSON)
DSTRule (XML) 		TimeTransitions
genericName (JSON)
GenericName (XML) 		TimezoneNames
ianaTimeZoneId (JSON)
IANATimeZoneID (XML)		 id
utcOffset (JSON)
UTCOffset (XML) 		ReferenceTime (StandardOffset)
windowsTimeZoneID (JSON)
WindowsTimeZoneID (XML)		 Wird nicht unterstützt. Verwenden Sie die Azure Maps Get Timezone Enum Windows-API, um in die Windows-Zeitzone zu konvertieren.

Weitere Informationen zu den Azure Maps Get Timezone By Coordinates-Antwortfeldern 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 Timezone-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.

Weitere Informationen

Weitere Azure Maps Timezone-APIs

Unterstützung

  • Last updated on