L'API Time Zone fournit des données de décalage horaire pour les lieux situés à la surface de la Terre. Demandez les informations sur le 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 à UTC et le décalage de l'heure d'été.
Exemple de requête et de réponse
Accédez à l'API Time Zone via une interface HTTPS, avec des requêtes construites sous forme de chaîne d'URL, en utilisant des coordonnées de latitude/longitude pour spécifier le location, un 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 est défini sur le 8 mars 2012.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Pour tester cela, saisissez l'URL dans votre navigateur Web (assurez-vous de remplacer YOUR_API_KEY par votre véritable clé API).
La réponse inclut les données de fuseau horaire pour le lieu et la date spécifiés (timestamp).
Pour en savoir plus sur la création d'URL de requête et les paramètres disponibles et sur la compréhension de la réponse, consultez le guide du développeur.
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 du service Web Google Maps en fournissant des implémentations natives simples des tâches courantes telles que l'authentification, la limitation du nombre de requêtes et la nouvelle tentative automatique. L'API Time Zone est disponible dans le client Java, le client Python, le client Go et le client 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 identifiants d'authentification appropriés. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform.
Quotas et tarifs
Consultez 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 relatives aux 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 d'autres langues que l'anglais (langue par défaut). Pour obtenir d'autres exemples et plus d'informations, consultez le guide du développeur de l'API Time Zone.
Le Guide du développeur de l'API Time Zone est destiné aux développeurs de sites Web et d'applications mobiles qui souhaitent inclure des données temporelles sur les cartes fournies par l'une des API Google Maps Platform. Il présente l'utilisation de l'API et fournit des informations de référence sur les paramètres disponibles.