Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Time Zone API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps Time Zone API
  3. Créer les clés appropriées
Continuer

Premiers pas

Google Maps Time Zone API fournit les données de décalage horaire pour des points géographiques sur la Terre. Vous demandez les informations de fuseau horaire pour une paire latitude/longitude et une date spécifiques. L'API renvoie le nom du fuseau horaire, ainsi que le décalage par rapport à l'heure UTC et par rapport à l'heure d'été.

Exemple de requête et de réponse

Vous accédez à Google Maps Time Zone API via une interface HTTPS, avec des requêtes construites en tant que chaînes d'URL utilisant des coordonnées de latitude/longitude pour spécifier le paramètre location, un paramètre timestamp pour indiquer la date, et votre clé d'API.

L'exemple suivant demande des données de fuseau horaire pour Washington, DC, États-Unis, 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 essayer par vous-même en saisissant l'URL dans votre navigateur Web (assurez-vous de remplacer « YOUR_API_KEY » par votre propre clé d'API). La réponse inclut les données de fuseau horaire pour le lieu et la date spécifiés (timestamp).

Reportez-vous au guide du développeur pour plus d'informations sur comment créer des URL de requête et définir les paramètres disponibles, ainsi que sur comment interpréter la réponse.

Un exemple de réponse est fourni ci-dessous, au format JSON :

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

Commencer à coder avec nos bibliothèques clients

Les bibliothèques clients facilitent le développement avec les API de services Web Google Maps, car elles fournissent des implémentations simples et natives de tâches courantes comme l'authentification, la limitation de requêtes et les nouvelles tentatives automatiques. Google Maps Time Zone API est disponible pour les clients Java Client, Python Client, Go Client et Node.js Client for Google Maps Services.

Authentification, quotas et politiques

Activer l'API et obtenir une clé d'API

Pour utiliser Google Maps Time Zone API, vous devez d'abord activer l'API dans Google API Console et obtenir les informations d'authentification appropriées. Vous devez fournir une clé d'API dans chaque requête (ou un ID client si vous avez souscrit un plan Premium).

Cliquez sur le bouton ci-dessous afin de suivre les étapes pour :

  1. Créer ou sélectionner un projet
  2. Activer l'API
  3. Obtenir une clé d'API
Obtenir une clé

En savoir plus sur les informations d'authentification.

Quotas

Consultez la page des limites d'utilisation pour en savoir plus sur les quotas définis pour Google Maps Time Zone API.

Politiques

L'utilisation de Google Maps Time Zone API doit être conforme aux politiques de l'API.

En savoir plus

Avec Time Zone API, vous pouvez également définir un paramètre de langue pour renvoyer les résultats dans une autre langue que l'anglais (la langue par défaut). Consultez le guide du développeur de Time Zone API pour plus d'exemples et de détails.

Envoyer des commentaires concernant…

Google Maps Time Zone API
Google Maps Time Zone API
Besoin d'aide ? Consultez notre page d'assistance.