Commencer

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

Exemple de requête et de réponse

Accédez à l'API Time Zone via une interface HTTPS, les requêtes étant formulées sous la forme d'une chaîne d'URL utilisant les coordonnées de latitude/longitude pour spécifier le location, le timestamp pour la date et la clé API.

La requête ci-dessous permet d'obtenir un fuseau horaire pour le Nevada, aux États-Unis. L'horodatage est défini sur 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'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

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

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

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

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Postier

La spécification OpenAPI est également disponible en tant que collection Postman.

Exécuter dans Postman

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

Consultez le guide du développeur pour en savoir plus sur la création d'URL de requêtes et les paramètres disponibles, et sur la compréhension de 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 simples et natives de tâches courantes telles que l'authentification, la limitation de requêtes et la nouvelle tentative automatique. L'API Time Zone est disponible dans les clients Java, Python, Go et Node.js pour les services Google Maps.

Authentification, quotas, tarification 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 de l'API.

En savoir plus

Dans l'API Time Zone, vous pouvez également définir un paramètre de langue pour obtenir des résultats dans des langues autres que la langue par défaut de l'anglais. Consultez le guide du développeur de l'API Time Zone pour obtenir d'autres exemples et d'autres informations.

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 des cartes fournies par l'une des API Google Maps Platform. Il fournit une introduction à l'utilisation de l'API et des documents de référence sur les paramètres disponibles.