Configurare l'API Weather

Questo documento descrive i passaggi necessari per iniziare a utilizzare l'API Weather.

Per iniziare a utilizzare l'API Weather, puoi richiedere una chiave demo di Maps o configurare un account e attivare la fatturazione.

Ottieni una chiave demo di Maps

La chiave demo di Maps è una funzionalità senza costi che ti consente di iniziare la prototipazione con l'API Weather senza inserire dati di fatturazione. La chiave demo di Maps è destinata esclusivamente a scopi di test e prototipazione e non è progettata per l'uso in produzione. Per saperne di più, consulta Ottieni una chiave demo di Maps e utilizzala con l'API Weather.

Ottieni una chiave API standard

Quando è tutto pronto per spostare il codice in produzione, completa i seguenti passaggi per creare una chiave API e attivare la fatturazione.

Prerequisiti

Questa procedura ti guida nella configurazione di un account Google Cloud e di un progetto cloud Google con la fatturazione abilitata. Dovresti anche conoscere i costi associati all'utilizzo dell'API Weather.

1. Esamina la fatturazione e i costi per l'utilizzo in Utilizzo e fatturazione dell'API Weather.

2. Verifica di avere un account Google Cloud.

   Accedi alla console Google Cloud

3. Verifica di avere un progetto Google Cloud con la fatturazione abilitata.

   Vai alla pagina Fatturazione
1. Seleziona il tuo progetto per aprire la pagina Fatturazione.

2. Nella pagina Fatturazione:

   • Se la fatturazione è già abilitata per il progetto selezionato e hai un solo account di fatturazione, si apre la pagina Fatturazione.
   • Se hai più account di fatturazione, seleziona Vai all'account di fatturazione collegato per visualizzare i dettagli dell'account di fatturazione associato al progetto.
   • Se esiste un account di fatturazione, ma non è associato al progetto, ti verrà chiesto di collegare un account di fatturazione al progetto.
   • Se non esiste un account di fatturazione o se vuoi crearne uno nuovo, seleziona Gestisci account di fatturazione per creare un nuovo account di fatturazione. Per saperne di più, consulta Crea un nuovo account di fatturazione Cloud self-service.

Abilita l'API

Prima di poter utilizzare l'API Weather, devi utilizzare la console Google Cloud o il comando gcloud per abilitarla nel tuo progetto Google Cloud.

Per abilitare l'API:

gcloud services enable \
    --project "PROJECT" \
    "weather.googleapis.com"

Ottieni una chiave API da utilizzare con l'API Weather

I prodotti Google Maps Platform sono protetti dall'utilizzo non autorizzato richiedendo che le chiamate API includano una chiave API o un token OAuth. La procedura per la chiave API è la prima. Per utilizzare un token OAuth, consulta Crea un token OAuth.

Una chiave API è una stringa alfanumerica univoca che associa il tuo account di fatturazione Cloud e il tuo progetto cloud Google Cloud alla richiesta effettuata dalla tua applicazione a un'API o un SDK di Google Maps Platform. Per creare una nuova chiave o aggiungere un'API o un SDK a una chiave esistente, segui queste istruzioni.

Effettua una richiesta API

Effettua una richiesta API Weather per restituire una risposta JSON per le informazioni sulle condizioni attuali di Mountain View, CA. Devi includere la stringa alfanumerica della chiave API in ogni richiesta e utilizzare HTTPS per le richieste che includono la chiave API.

1. Fai clic su API_KEY nel codice di seguito per inserire la stringa alfanumerica della chiave:

   curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220&location.longitude=-122.0841"
   

2. Fai clic sull'icona di copia nell'esempio di codice, , per copiare il comando curl.
3. Incolla il comando in una finestra del terminale ed eseguilo.

La risposta è un oggetto JSON nel formato:

{
  "currentTime": "2025-07-01T12:33:24.606422609Z",
  "timeZone": {
    "id": "America/Los_Angeles"
  },
  "isDaytime": false,
  "weatherCondition": {
    "iconBaseUri": "https://maps.gstatic.com/weather/v1/partly_clear",
    "description": {
      "text": "Partly cloudy",
      "languageCode": "en"
    },
    "type": "PARTLY_CLOUDY"
  },
  "temperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "feelsLikeTemperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "dewPoint": {
    "degrees": 12,
    "unit": "CELSIUS"
  },
  "heatIndex": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "windChill": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "relativeHumidity": 78,
  "uvIndex": 0,
  "precipitation": {
    "probability": {
      "percent": 3,
      "type": "RAIN"
    },
    "snowQpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    },
    "qpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    }
  },
  "thunderstormProbability": 0,
  "airPressure": {
    "meanSeaLevelMillibars": 1011.5
  },
  ...
}

Applica le limitazioni relative alle chiavi API

Google consiglia vivamente di limitare le chiavi API limitandone l'utilizzo solo alle API e alle app che ne hanno bisogno. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola da richieste ingiustificate. Le chiavi API supportano due tipi di limitazioni:

• Le restrizioni delle API specificano quali SDK e API possono essere chiamati utilizzando la chiave API. La console e gcloud CLI richiedono almeno una restrizione API quando crei una chiave.
• Le restrizioni delle applicazioni specificano i siti web, gli indirizzi IP o le app che possono utilizzare una chiave API.

Per saperne di più sull'applicazione delle limitazioni, consulta Limita le chiavi API.

Crea un token OAuth

L'API Weather supporta OAuth 2.0 per l'autenticazione. Google supporta scenari OAuth 2.0 comuni, ad esempio per un server web.

Questo documento descrive come passare un token OAuth a una chiamata API Weather nel tuo ambiente di sviluppo. Per saperne di più sull'utilizzo di OAuth in un ambiente di produzione, consulta Metodi di autenticazione di Google.

Panoramica di OAuth

Puoi creare e gestire i token di accesso con OAuth in diversi modi, a seconda dell'ambiente di deployment.

Puoi utilizzare OAuth 2.0 per le interazioni server-to-server tra la tua applicazione e un servizio Google. Per questo scenario, utilizzi un service account associato alla tua applicazione anziché a un singolo utente. Puoi effettuare richieste API utilizzando il service account senza coinvolgere direttamente gli utenti. Per saperne di più sui metodi di autenticazione, consulta Metodi di autenticazione di Google.

In alternativa, puoi integrare l'API Weather in un'app mobile Android o iOS. Per ulteriori informazioni sull'utilizzo di OAuth e sulla gestione dei token di accesso per diversi ambienti di deployment, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Ambiti OAuth

Per utilizzare OAuth con l'API Weather, devi assegnare al token OAuth il seguente ambito:

https://www.googleapis.com/auth/cloud-platform

Esempio: prova le chiamate API REST nel tuo ambiente di sviluppo locale

Se non hai un ambiente che genera token e vuoi provare l'API Weather con un token OAuth, utilizza la procedura descritta in questa sezione.

Questo esempio descrive come utilizzare il token OAuth fornito dalle Credenziali predefinite dell'applicazione (ADC) per effettuare la chiamata. Per saperne di più sull'utilizzo di ADC per chiamare le API di Google con le librerie client, consulta Autenticati utilizzando le librerie client.

Utilizza la seguente procedura REST solo per lo sviluppo o i test, non per la produzione.

Prerequisiti

Prima di effettuare una richiesta REST utilizzando ADC, utilizza l'interfaccia a riga di comando gcloud per fornire le credenziali ad ADC:

1. Installa e inizializza l'interfaccia a riga di comando gcloud. Per saperne di più, consulta Installa gcloud CLI.

2. Esegui l'autenticazione con l'interfaccia a riga di comando gcloud:

   gcloud auth application-default login

3. Completa la procedura di accesso per salvare le tue credenziali nel file delle credenziali locali utilizzato da ADC.

Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

Effettua una richiesta REST

In questo esempio, passi due intestazioni della richiesta:

• Passa il token OAuth nell'intestazione Authorization utilizzando il seguente comando per generare il token:

  gcloud auth application-default print-access-token

  Il token restituito ha un ambito di https://www.googleapis.com/auth/cloud-platform.

• Passa l'ID o il nome del tuo progetto cloud Google Cloud con la fatturazione abilitata nell'intestazione X-Goog-User-Project.

Per chiamare l'API Weather utilizzando un token OAuth, completa i seguenti passaggi:

1. Nel seguente esempio di codice, sostituisci PROJECT_NUMBER_OR_ID con il numero o l'ID del tuo progetto Google Cloud:

   curl -X GET \
   -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   "https://weather.googleapis.com/v1/currentConditions:lookup?location.latitude=37.4220&location.longitude=-122.0841"

2. Per copiare il comando curl, fai clic su Copia nell'esempio di codice.

3. Incolla il comando in una finestra del terminale, quindi eseguilo.

La risposta è un oggetto JSON:

{
  "currentTime": "2025-07-01T12:33:24.606422609Z",
  "timeZone": {
    "id": "America/Los_Angeles"
  },
  "isDaytime": false,
  "weatherCondition": {
    "iconBaseUri": "https://maps.gstatic.com/weather/v1/partly_clear",
    "description": {
      "text": "Partly cloudy",
      "languageCode": "en"
    },
    "type": "PARTLY_CLOUDY"
  },
  "temperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "feelsLikeTemperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "dewPoint": {
    "degrees": 12,
    "unit": "CELSIUS"
  },
  "heatIndex": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "windChill": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "relativeHumidity": 78,
  "uvIndex": 0,
  "precipitation": {
    "probability": {
      "percent": 3,
      "type": "RAIN"
    },
    "snowQpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    },
    "qpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    }
  },
  "thunderstormProbability": 0,
  "airPressure": {
    "meanSeaLevelMillibars": 1011.5
  },
  ...
}

Risoluzione dei problemi

Se la richiesta restituisce un messaggio di errore che indica che questa API non supporta le credenziali dell'utente finale, consulta Risolvi i problemi di configurazione di ADC.

Passaggi successivi

Ora che hai abilitato l'API Weather e hai effettuato una richiesta con successo, consulta Ottieni le condizioni attuali per scoprire di più sull'utilizzo dell'API.