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 de l'emplacement, y compris les décalages pour 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'identifiant du fuseau horaire et le nom des dates et 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 à l'heure UTC et pour l'heure d'été.

Les données de fuseau horaire peuvent être particulièrement utiles lorsque vous souhaitez que votre site Web ou votre 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 de lieux situés sur la surface de la Terre, avec le décalage horaire par rapport à l'heure UTC et pour l'heure d'été de chacun de ces lieux.

Fonctionnement de l'API Time Zone

L'API Time Zone accepte une requête HTTPS comportant des coordonnées de latitude/longitude, la date et l'heure souhaitées sous forme d'horodatage et, éventuellement, un code de langue. Les données sont renvoyé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 qu'elle renvoie.

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

Vous indiquez votre demande ainsi que le lieu et l'horodatage. Consultez la section Paramètres obligatoires.

  • Identifiant du fuseau horaire.
  • Nom du fuseau horaire, localisé éventuellement
  • Décalage par rapport à l'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, puis suivez les instructions de configuration.
2 Envoyer une requête de fuseau horaire Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Time Zone directement dans votre navigateur. Pour en savoir plus, consultez les exemples de fuseau horaire dans le guide Requêtes et réponses de 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 Réponses de fuseau horaire .
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 des utilisateurs en fonction de leur fuseau horaire.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de votre choix via 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.

Étapes suivantes