L’API de fuseau horaire fournit des données de décalage horaire pour des emplacements à la surface de la terre. Demandez les informations sur le fuseau horaire pour un couple latitude/longitude et une date spécifiques. L’API renvoie le nom de ce fuseau horaire, le décalage horaire par rapport à UTC et le décalage de l’heure d’été.

Exemple de demande et de réponse

Accédez à l’API Time Zone via une interface HTTPS, avec des demandes construites sous forme de chaîne URL, en utilisant les coordonnées de latitude/longitude pour spécifier le location, un timestamp pour spécifier la date et votre clé API.

L’exemple suivant demande les données de fuseau horaire pour Washington, DC, USA, le 15 mars 2016, au format JSON :

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Vous pouvez le tester en entrant l’URL dans votre navigateur web (veillez à remplacer YOUR_API_KEY par votre clé API réelle). La réponse inclut les données de fuseau horaire pour le lieu et la date spécifiés (timestamp).

Voir le guide du développeur pour plus d’informations sur la construction des URL de requête et des paramètres disponibles et la compréhension de la réponse.

Vous trouverez ci-dessous un exemple de réponse, en JSON :

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Commencez à coder avec nos bibliothèques clientes

Les bibliothèques clientes facilitent le développement avec les API de services Web de Google Maps en fournissant des implémentations simples et natives de tâches courantes telles que l’authentification, la limitation des demandes et la relance automatique. L’API de fuseau horaire est disponible dans le client Java, le client Python, le client Go et le client Node.js pour les services Google Maps.

Authentification, quotas, tarification et politiques

Authentification

Pour utiliser l’API de fuseau horaire, vous devez d’abord activer l’API et obtenir les informations d’authentification appropriées. Pour plus d’informations, consultez la rubrique Démarrer avec Google Maps Platform.

Quotas et tarification

Vérifiez la page d’utilisation et de facturation pour obtenir des détails sur les quotas et la tarification définis pour l’API de fuseau horaire.

Politiques

L’utilisation de l’API Time Zone doit être conforme aux politiques de l’API.

Learn more

Dans l’API Time Zone, vous pouvez également définir un paramètre de langue pour renvoyer des résultats dans des langues autres que l’anglais par défaut. Consultez le Guide du développeur de l’API de fuseau horaire pour plus d’exemples et d’autres détails.