Présentation de l'API Time Zone

L'API Time Zone est un service qui accepte une requête HTTP des ses coordonnées de latitude/longitude, ainsi que la date et l'heure souhaitées. Elle renvoie l'heure données de zone pour le lieu, y compris les décalages pour l'UTC et l'heure d'été
.

Pourquoi utiliser l'API Time Zone ?

Avec l'API Time Zone, vous pouvez développer des applications qui fournissent L'identifiant et le nom du fuseau horaire pour les dates et les heures de lieux spécifiques sur une carte. Par exemple, vous pouvez afficher les éléments suivants : données de fuseau horaire:

  • Noms des fuseaux horaires localisés pour les emplacements sur la carte issus de Google Maps Platform.
  • Décalages de fuseau horaire par rapport à l'heure UTC et pour l'heure d'été

Les données de fuseau horaire peuvent être particulièrement utiles lorsque vous souhaitez connaître affichent des données temporelles pertinentes pour vos utilisateurs sur votre site Web ou votre application.

Ce que vous pouvez faire avec l'API Time Zone

Avec l'API Time Zone, vous pouvez demander le fuseau horaire de des lieux situés à la surface de la Terre, en décalant les fuseaux horaires par rapport à UTC et pour le passage à l'heure d'été ces emplacements.

Fonctionnement de l'API Time Zone

L'API Time Zone accepte une requête HTTPS de latitude/longitude. les coordonnées géographiques, la date et l'heure souhaitées sous forme d'horodatage et, éventuellement, un code de langue. Elle renvoie des données au format spécifié par la requête. L'exemple suivant montre une requête Nevada, États-Unis, avec une sortie demandée au format JSON.

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY
  

Ressources

Le tableau suivant récapitule les ressources disponibles via le API Time Zone et les données qu'elle renvoie.

Ressources de données Données renvoyées Format de retour
Fuseau horaire

Vous indiquez votre demande, ainsi que l'emplacement et le code temporel. Voir obligatoire paramètres.

  • ID du fuseau horaire.
  • Nom du fuseau horaire, éventuellement localisé
  • Décalage par rapport à l'heure UTC, en secondes
  • Décalage pour le passage à l'heure d'été, en secondes
  • Consultez la section "Fuseau horaire" pour obtenir des exemples de réponses spécifiques.
  • JSON
  • XML

Utiliser l'API Time Zone

1 Configuration Commencez par Configurer votre Projet Google Cloud et terminez la configuration en suivant les instructions ci-dessous.
2 Essayer une requête de fuseau horaire Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Time Zone directement depuis votre navigateur. Consultez des exemples de fuseaux horaires. dans le guide Requêtes et réponses liées aux fuseaux horaires pour en savoir plus.
3 Comprendre les principes de base des réponses Découvrez comment utiliser les données de fuseau horaire dans votre application ou votre site Web. Consultez la section Réponses basées sur le fuseau horaire. pour en savoir plus.
5 Intégrez des données de fuseau horaire dans votre propre application. Vous pouvez utiliser les données de fuseau horaire pour améliorer les applications et les sites Web pour les utilisateurs différents paramètres régionaux en fonction de l'heure.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de de votre choix via l'une des bibliothèques clientes suivantes:

Les clients Java, Python, Go et Node.js pour Google Maps Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du Licence Apache 2.0 Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante