Présentation de l'API Time Zone

L'API Time Zone est un service qui accepte une requête HTTP de coordonnées de latitude/longitude ainsi que la date et l'heure souhaitées. Elle renvoie les données de fuseau horaire du lieu, y compris les décalages par rapport à l'heure 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 de fuseau horaire et le nom 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 de carte à partir de Google Maps Platform.
  • Décalages de fuseau horaire par rapport à UTC et pour le passage à l'heure d'été.

Les données de fuseau horaire sont particulièrement utiles lorsque vous souhaitez que votre site Web ou application affiche des données temporelles pertinentes pour vos utilisateurs.

Ce que vous pouvez faire avec l'API Time Zone

Avec l'API Time Zone, vous pouvez demander le fuseau horaire des emplacements situés à 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 de coordonnées de latitude/longitude, la date et l'heure souhaitées en tant qu'horodatage 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=1331161200
    &key=YOUR_API_KEY

Ressources

Le tableau suivant récapitule les ressources disponibles via l'API Time Zone, ainsi que les données renvoyées.

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

Vous fournissez votre requête ainsi que l'emplacement et l'horodatage. Consultez les paramètres obligatoires.

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

Utiliser l'API Time Zone

1 Commencer 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 la section Exemples de fuseaux horaires du guide Requêtes et fuseaux horaires.
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 la section Réponses de fuseau horaire .
5 Intégrez les 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 des utilisateurs dans différentes régions au fil du temps.

Bibliothèques clientes disponibles

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

Le client Java, le client Python, le client Go et le client Node.js pour les services Google Maps sont des bibliothèques clientes compatibles avec la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étapes suivantes