Présentation de l'API Time Zone

L'API Time Zone est un service qui accepte les requêtes HTTP des ses coordonnées de latitude/longitude, ainsi que la date et l'heure choisies. Il renvoie les données de fuseau horaire pour l'emplacement, y compris les décalages pour l'UTC et l'heure d'été.

Pourquoi utiliser l'API Time Zone ?

Avec l'API Fuseau horaire, vous pouvez développer des applications qui fournissent l'ID et le nom du fuseau horaire pour les dates et heures à des emplacements spécifiques sur une carte. Par exemple, vous pouvez afficher les données de fuseau horaire suivantes :

  • 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.

Fonctionnalités de l'API Time Zone

Avec l'API Time Zone, vous pouvez demander le fuseau horaire de à 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. Il renvoie les 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 l'API Time Zone, ainsi que les données qu'elle renvoie.

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

Vous fournissez votre requête, ainsi que votre position et un 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 Essayez 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 à 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 la langue 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 sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante