Eseguire la migrazione dell'API Find Time Zones di Bing Maps

Articolo
05/23/2024

Questo articolo spiega come eseguire la migrazione dell'API Find Time Zone di Bing Maps all'API Get Time Zone By Coordinates di Mappe di Azure. L'API Get Timezone By Coordinates di Mappe di Azure restituisce le informazioni sul fuso orario correnti, passate e future per una coppia di longitudine di latitudine e longitudine specificate, oltre al tramonto e all'alba per una determinata posizione.

Prerequisiti

Un account Azure
Un account Mappe di Azure
Una chiave di sottoscrizione o un altro tipo di autenticazione con Mappe di Azure

Differenze rilevanti

L'API Find Time Zone di Bing Maps supporta coordinate e località, area amministrativa e nome paese/area geografica come input della posizione. L'API Get Timezone By Coordinates di Mappe di Azure supporta solo le coordinate. Per ottenere le coordinate per il nome, l'area amministrativa e il nome del paese o dell'area geografica, è possibile usare l'API Get Geocoding di Mappe di Azure.
L'API Find Time Zone di Bing Maps supporta sia i formati di risposta XML che JSON, l'API Get Timezone By Coordinates di Mappe di Azure supporta solo JSON.
L'API Find Time Zone di Bing Maps non offre valori di alba e tramonto per un determinato fuso orario, l'API Get Time Zone By Coordinates di Mappe di Azure lo fa.
A differenza di Bing Maps for Enterprise, Mappe di Azure è un servizio globale che supporta la specifica di un ambito geografico, il che consente di limitare la residenza dei dati alle aree geografiche di Europa (UE) o Stati Uniti (US). Tutte le richieste (inclusi i dati di input) vengono elaborate esclusivamente nell'area geografica specificata. Per altre informazioni, vedere Ambito geografico del servizio Mappe di Azure.

Sicurezza e autenticazione

Bing Maps for Enterprise supporta solo l'autenticazione con chiave API. Mappe di Azure supporta diversi modi per autenticare le chiamate API, ad esempio una chiave di sottoscrizione, Microsoft Entra ID o il token di firma di accesso condiviso (SAS). Per altre informazioni sulla sicurezza e l'autenticazione in Mappe di Azure, vedere Autenticazione con Mappe di Azure e la sezione Sicurezza nella documentazione Mappe di Azure Ottenere il fuso orario in base alle coordinate.

Parametri della richiesta

La tabella seguente elenca i parametri di richiesta Find Time Zone di Bing Maps e l'equivalente di Mappe di Azure:

Parametro di Bing Maps	Alias parametro di Bing Maps	Parametro di Mappe di Azure	Obbligatorio in Mappe di Azure	Mappe di Azure tipo di dati	Descrizione
dateTime	dt	Timestamp	Falso	string date-time	In alternativa, usare l'alias "stamp" o "s". Ora di riferimento, se omessa, l'API usa l'ora del computer che gestisce la richiesta.
IncludeDstRules	nessuno	transitionsFrom	Falso	string date-time	La data di inizio dalla quale vengono richieste transizioni all'ora legale; si applica solo quando "options" = all o "options" = transitions. Per altre informazioni, vedere il parametro options (Opzioni fuso orario).
output	o	format	Vero	JSONFormat	In questa API mappe di Azure è supportato solo il formato JSON.
point	nessuno	query	Vero	number	Coordinate del punto per cui vengono richieste le informazioni sul fuso orario. Questo parametro è un elenco di coordinate, contenente una coppia di valori di coordinate (lat, long). Quando questo endpoint viene chiamato direttamente, le coordinate vengono passate come singola stringa contenente coordinate, separate da virgole.
query	q	Non supportato	Non supportato	Non supportato	Sono supportate solo le coordinate del punto per cui vengono richieste le informazioni sul fuso orario. I tipi di posizione, ad esempio indirizzo, località, codice postale e così via, non sono supportati. Per ottenere le coordinate per il nome, l'area amministrativa e il nome del paese o dell'area geografica, è possibile usare l'API Get Geocoding di Mappe di Azure.

Per altre informazioni, vedere Get Timezone by Coordinates URI Parameters.

Esempi di richiesta

Richiesta dell'API Find Time Zones di Bing Maps:

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

Richiesta dell'API Get Time Zone by Coordinates di Mappe di Azure:

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

Campi di risposta

La tabella seguente elenca i campi che possono essere visualizzati nella risposta HTTP durante l'esecuzione dell'API Find Time Zone di Bing Maps e dell'equivalente di Mappe di Azure:

Campo risposta di Bing Mappe	campo di risposta Mappe di Azure
abbreviazione (JSON) Abbreviazione (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)	Non supportato. Usare l'API Windows Get Timezone Enum di Mappe di Azure per eseguire la conversione nel fuso orario di Windows.

Per altre informazioni sui campi di risposta di Get Timezone By Coordinates di Mappe di Azure, vedere le Definizioni di risposta.

Esempi di risposta

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta dell'API Find Time Zone di Bing Maps:

{
    "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"
}

L'esempio seguente illustra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta API Get Time Zone By Coordinates di Mappe di Azure:

{
    "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"
                }
            ]
        }
    ]
}

Utilizzo delle transazioni

Analogamente all'API Find Time Zone di Bing Maps for Enterprise, l'API Get Timezone By Coordinates di Mappe di Azure registra una transazione fatturabile per ogni richiesta API. Per altre informazioni sulle transazioni di Mappe di Azure, vedere Informazioni sulle transazioni di Mappe di Azure.

Informazioni aggiuntive

Altre API per il fuso orario di Mappe di Azure

Supporto tecnico

Forum di domande e risposte Microsoft

Condividi tramite