Commencer

L'API Time Zone fournit des données de décalage horaire pour les lieux situés sur la surface de la sur Terre. Demander les informations de fuseau horaire pour une paire latitude/longitude et une date spécifiques L'API renvoie le nom de ce fuseau horaire, le décalage horaire par rapport à l'heure UTC et le paramètre le décalage horaire.

Exemple de requête et de réponse

Accédez à l'API Time Zone via une interface HTTPS, avec des requêtes construites comme une chaîne d'URL, en utilisant des coordonnées de latitude/longitude pour spécifiez location, timestamp pour spécifier la date, et votre clé API.

La requête ci-dessous permet d'obtenir un fuseau horaire pour le Nevada, aux États-Unis. Le code temporel a été définie pour le 8 mars 2012.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY'

Pour ce faire, saisissez 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)

Consultez le guide du développeur. pour en savoir plus sur <ph type="x-smartling-placeholder"></ph> création d'URL de demande et de paramètres disponibles et comprendre la réponse.

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

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

Commencer à coder avec nos bibliothèques clients

Les bibliothèques clientes facilitent le développement avec les API de services Web Google Maps en fournissant des implémentations natives de tâches courantes telles que l'authentification, la limitation et les nouvelles tentatives automatiques. L'API Time Zone est disponible dans Client Java, les clients Python, Go et Node.js pour les services Google Maps.

Authentification, quotas, tarifs et règles

Authentification

Pour utiliser l'API Time Zone, vous devez d'abord l'activer et obtenir les d'authentification unique. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform

Quotas et tarifs

Consulter la page Utilisation et facturation pour en savoir plus sur les quotas et les tarifs définis pour l'API Time Zone.

Règles

L'utilisation de l'API Time Zone doit être conforme aux Règles de l'API

En savoir plus

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 API Time Zone Guide du développeur pour obtenir plus d'exemples et d'informations.

Le Le guide du développeur de l'API Time Zone est destiné aux sites Web et aux appareils mobiles. Développeurs qui souhaitent inclure des données temporelles dans les cartes fournies par l'une des plates-formes Google Maps Platform API. Il présente l'utilisation de l'API et fournit des documents de référence sur les paramètres.