![Présentation de l'API Timezone](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=6&hl=fr)
L'API Time Zone est un service qui accepte une requête HTTP des
ses coordonnées de latitude/longitude, ainsi que la date et l'heure souhaitées. Elle renvoie l'heure
données de zone pour le lieu, y compris les décalages pour l'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 et le nom du fuseau horaire pour les dates et les heures de lieux spécifiques sur une carte. Par exemple, vous pouvez afficher les éléments suivants : données de fuseau horaire:
- Noms des fuseaux horaires localisés pour les emplacements sur la carte issus 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 connaître affichent des données temporelles pertinentes pour vos utilisateurs sur votre site Web ou votre application.
Ce que vous pouvez faire avec l'API Time Zone
Avec l'API Time Zone, vous pouvez demander le fuseau horaire de des lieux situés à la surface de la Terre, en décalant les fuseaux horaires par rapport à UTC et pour le passage à l'heure d'été ces emplacements.
Fonctionnement de l'API Time Zone
L'API Time Zone accepte une requête HTTPS de latitude/longitude. les coordonnées géographiques, la date et l'heure souhaitées sous forme d'horodatage et, éventuellement, un code de langue. Elle renvoie des données au format spécifié par la requête. L'exemple suivant montre une requête Nevada, États-Unis, avec une sortie demandée au format JSON.
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1331161200 &key=YOUR_API_KEY
Ressources
Le tableau suivant récapitule les ressources disponibles via le API Time Zone et les données qu'elle renvoie.
Ressources de données | Données renvoyées | Format de retour |
---|---|---|
Fuseau horaire
Vous indiquez votre demande, ainsi que l'emplacement et le code temporel. Voir obligatoire paramètres. |
|
|
Utiliser l'API Time Zone
1 | Configuration | Commencez par Configurer votre Projet Google Cloud et terminez la configuration en suivant les instructions ci-dessous. |
2 | Essayer une requête de fuseau horaire | Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Time Zone directement depuis votre navigateur. Consultez des exemples de fuseaux horaires. dans le guide Requêtes et réponses liées aux fuseaux horaires pour en savoir plus. |
3 | Comprendre les principes de base des réponses | Découvrez comment utiliser les données de fuseau horaire dans votre application ou votre site Web. Consultez la section Réponses basées sur le fuseau horaire. pour en savoir plus. |
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 pour les utilisateurs différents paramètres régionaux en fonction de l'heure. |
Bibliothèques clientes disponibles
Appelez cette API dans le langage de de votre choix via l'une des bibliothèques clientes suivantes:
- Java Client pour les services Google Maps
- Python Client pour les services Google Maps
- Client Go pour les services Google Maps
- Node.js Client pour les services Google Maps
Les clients Java, Python, Go et Node.js pour Google Maps Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du Licence Apache 2.0 Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Étape suivante
- Découvrez comment envoyer des requêtes de fuseau horaire: accédez à Requêtes et réponses liées au fuseau horaire
- Suivez les bonnes pratiques: accédez à Bonnes pratiques concernant les services Web.