Configurare l'API Roads

Questo documento descrive i passaggi necessari per iniziare a utilizzare Roads API.

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 le modalità di addebito per l'utilizzo di Roads API.

1. Esamina la fatturazione e i costi di utilizzo in Roads API Utilizzo e fatturazione.

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 Roads API, devi abilitarlo nel tuo progetto Google Cloud utilizzando la console Google Cloud o il comando gcloud.

Per abilitare l'API:

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

Ottieni una chiave API da utilizzare con Roads API

I prodotti Google Maps Platform sono protetti dall'utilizzo non autorizzato richiedendo che le chiamate API includano una chiave API.

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

Invia una richiesta Roads API per restituire una risposta JSON che aggancia i punti specificati alla geometria della strada. 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 -L -X GET 'https://roads.googleapis.com/v1/snapToRoads?path=-35.27801%2C149.12958%7C-35.28032%2C149.12907%7C-35.28099%2C149.12929%7C-35.28144%2C149.12984%7C-35.28194%2C149.13003%7C-35.28282%2C149.12956%7C-35.28302%2C149.12881%7C-35.28473%2C149.12836&interpolate=true&key=YOUR_API_KEY'
   

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:

{
  "snappedPoints": [
    {
      "location": {
        "latitude": -35.278004899930188,
        "longitude": 149.129531998742
      },
      "originalIndex": 0,
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    {
      "location": {
        "latitude": -35.2784195,
        "longitude": 149.12946589999999
      },
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    ...
    {
      "location": {
        "latitude": -35.284727644851415,
        "longitude": 149.12833853807396
      },
      "originalIndex": 7,
      "placeId": "ChIJtWxAZmpNFmsRlbUCkc6VtnA"
    }
  ]
}

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.

Passaggi successivi

Ora che hai abilitato Roads API e inviato una richiesta con esito positivo, consulta Posizionamento su strada per scoprire di più sull'utilizzo dell'API.