Compartir a través de

Migración de la API de búsqueda de zona horaria de Mapas de Bing

En este artículo se explica cómo migrar de la API de búsqueda de zona horaria de Mapas de Bing a la API de obtención de zonas horarias por coordenadas de Azure Maps. La API de obtención de zona horaria por coordenadas de Azure Maps devuelve información de zona horaria actual, histórica y futura para un par de latitud-longitud especificado, así como las horas de puesta y salida del sol de una ubicación determinada.

Requisitos previos

Diferencias destacadas

  • La API de búsqueda de zona horaria de Mapas de Bing admite coordenadas y nombre de lugar de ubicación, región administrativa y nombre de país o región como entrada de ubicación. La API de obtención de zona horaria por coordenadas de Azure Maps solo admite coordenadas. Para obtener las coordenadas del nombre de lugar de ubicación, la región administrativa y el nombre de país o región, puede usar la API de obtención de geocodificación de Azure Maps.
  • La API de búsqueda de zona horaria de Mapas de Bing admite formatos de respuesta XML y JSON, pero la API de obtención de zona horaria por coordenadas de Azure Maps solo admite JSON.
  • La API de búsqueda de zona horaria de Mapas de Bing no ofrece valores de salida y puesta de sol para una zona horaria determinada, pero la API de obtención de zona horaria por coordenadas de Azure Maps sí.
  • A diferencia de Mapas de Bing para la empresa, Azure Maps es un servicio global que admite la especificación de un ámbito geográfico, lo que le permite limitar la residencia de datos a las áreas geográficas (geoáreas) de Europa (EU) o Estados Unidos (EE. UU.). Todas las solicitudes (incluidos los datos de entrada) se procesan exclusivamente en el área geográfica especificada. Para obtener más información, consulte Ámbito geográfico del servicio de Azure Maps.

Seguridad y autenticación

Mapas de Bing para la empresa solo admite la autenticación de clave de API. Azure Maps admite varias formas de autenticar las llamadas API, como una clave de suscripción, Microsoft Entra ID o un token de firma de acceso compartido (SAS). Para más información sobre la seguridad y la autenticación en Azure Maps, consulte Autenticación con Azure Maps y la sección Seguridad en la documentación de Obtención de zona horaria por coordenadas de Azure Maps.

Parámetros de solicitud

En la tabla siguiente se enumeran los parámetros de solicitud de Búsqueda de zona horaria de Mapas de Bing y el equivalente de Azure Maps:

Parámetro de Mapas de Bing Alias de parámetro de Mapas de Bing Parámetro de Azure Maps Obligatorio en Azure Maps Tipo de datos de Azure Maps Descripción
dateTime dt timeStamp False string date-time Como alternativa, use alias "stamp" o "s". Hora de referencia: si se omite, la API usa la hora de la máquina que atiende la solicitud.
IncludeDstRules Ninguno transitionsFrom False string date-time La fecha de inicio a partir de la cual se solicitan transiciones de horario de verano (DST), solo se aplica cuando "options" = all o "options" = transitions. Consulte el parámetro Opciones (opciones de zona horaria) para obtener más información.  
output o format True JSONFormat Solo se admite el formato JSON en esta API de Azure Maps.
point Ninguno query True number Coordenadas del punto para el que se solicita información de zona horaria. Este parámetro es una lista de coordenadas, que contiene un par de valores de coordenadas (lat, long). Cuando se llama directamente a este punto de conexión, las coordenadas se pasan como una sola cadena que contiene coordenadas, separadas por comas.
consulta q No compatible No compatible No compatible Solo se admiten las coordenadas del punto para el que se solicita información de zona horaria. No se admiten tipos de ubicación como dirección, localidad, código postal, etc. Para obtener las coordenadas del nombre de lugar de ubicación, la región administrativa y el nombre de país o región, puede usar la API de obtención de geocodificación de Azure Maps.

Para obtener más información, consulte los parámetros de URI de obtención de zona horaria por coordenadas de Azure Maps.

Ejemplos de solicitud

Solicitud de la API de Búsqueda de zona horaria de Mapas de Bing:

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

Solicitud de la API de Obtención de zona horaria por coordenadas de Azure Maps:

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

Campos de respuesta

En la tabla siguiente se enumeran los campos que pueden aparecer en la respuesta HTTP al ejecutar la API de búsqueda de zona horaria de Mapas de Bing y el equivalente de Azure Maps:

Campo de respuesta de Mapas de Bing Campo de respuesta de Azure Maps
abreviatura (JSON)
Abreviatura (XML) 		ReferenceTime (etiqueta)
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)		 No admitida. Use la API de obtención de enumeración de zona horaria de Windows de Azure Maps para convertirla en zona horaria de Windows.

Para obtener más información sobre los campos de respuesta de obtención de zona horaria por coordenadas de Azure Maps, consulte la respuesta Definiciones.

Ejemplos de respuesta

El siguiente JSON muestra un ejemplo de lo que se devuelve en el cuerpo de la respuesta HTTP al ejecutar la solicitud de la API de Búsqueda de zona horaria de Mapas de Bing:

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

En el ejemplo siguiente se muestra lo que se devuelve en el cuerpo de la respuesta HTTP al ejecutar una solicitud de la API de Obtención de zona horaria por coordenadas de Azure Maps:

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

Uso de transacciones

De forma similar a la API de búsqueda de zona horaria de Mapas de Bing para empresas, la API de obtención de zona horaria por coordenadas de Azure Maps registra una transacción facturable por la solicitud de API. Para más información sobre las transacciones de Azure Maps, vea Descripción de las transacciones de Azure Maps.

Información adicional

Más API de zona horaria de Azure Maps

Soporte técnico

  • Last updated on