Présentation de l'API Time Zone

L'API Time Zone est un service qui accepte une requête HTTP contenant des coordonnées de latitude/longitude, ainsi qu'une date et une heure. Elle renvoie les données de fuseau horaire de l'emplacement, y compris les décalages par rapport au temps universel coordonné (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'ID et le nom du fuseau horaire pour des dates et des heures à des emplacements spécifiques sur une carte. Par exemple, vous pouvez afficher les données de fuseau horaire suivantes :

  • Noms de fuseaux horaires localisés pour les emplacements sur la carte 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 sont particulièrement utiles lorsque vous souhaitez que votre site Web ou votre application affiche des données temporelles pertinentes pour les utilisateurs de votre application.

Ce que vous pouvez faire avec l'API Time Zone

Avec l'API Time Zone, vous pouvez demander le fuseau horaire de lieux sur la surface de la Terre, avec le décalage horaire par rapport à l'heure UTC et l'heure d'été pour chacun de ces lieux.

Fonctionnement de l'API Time Zone

L'API Time Zone accepte une requête HTTPS contenant des coordonnées de latitude et de longitude, la date et l'heure sélectionnées sous forme de code temporel, et éventuellement un code de langue. Elle renvoie les données au format spécifié par la requête. L'exemple suivant montre une requête pour le Nevada, aux É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=1733428634
  &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 le lieu et le code temporel. Consultez la section Paramètres obligatoires.
  • ID du fuseau horaire.
  • Nom du fuseau horaire, éventuellement localisé.
  • Décalage par rapport à l'heure UTC, en secondes.
  • Décalage pour 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 Configurer Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent.
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. Pour en savoir plus, consultez les exemples de fuseaux horaires dans le guide Requêtes et réponses de fuseau horaire.
3 Comprendre les principes de base des réponses Découvrez comment utiliser les données de fuseau horaire dans votre application ou sur votre site Web. Pour en savoir plus, consultez Réponses de l'API Time Zone.
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 dans différents paramètres régionaux basés sur l'heure.

Bibliothèques clientes disponibles

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

Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la 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