Guida rapida dell'API Maps Embed

Inserisci una mappa interattiva o un panorama di Street View nella tua pagina web con una semplice richiesta HTTP, senza dover utilizzare JavaScript.

Costi

Tutte le richieste API Maps Embed sono disponibili senza costi con un utilizzo illimitato. Tuttavia, tutte le richieste richiedono comunque una chiave API Google Cloud valida. Per ulteriori informazioni, consulta la sezione Utilizzo e fatturazione.

Prima di iniziare

Per creare una mappa incorporata nella tua pagina web, completa i passaggi di configurazione richiesti facendo clic sulle seguenti schede:

Passaggio 1

Console

1. Nella pagina del selettore di progetti della console Google Cloud, fai clic su Crea progetto per iniziare a creare un nuovo progetto Cloud.

   Vai alla pagina del selettore progetti

2. Verifica che la fatturazione sia attivata per il tuo progetto Cloud. Verifica che la fatturazione sia abilitata per il progetto.

   Nota: sebbene sia necessario configurare un account di fatturazione per configurare un progetto Cloud, l'utilizzo effettivo dell'API Embed è disponibile senza costi aggiuntivi.

   Google Cloud offre una prova con addebito di 0,00 $. La prova scade dopo 90 giorni o dopo che l'account ha accumulato 300 $di addebiti, a seconda dell'evento che si verifica per primo. Puoi annullare l'abbonamento in qualsiasi momento. Google Maps Platform offre un credito mensile ricorrente di 200 $. Per maggiori informazioni, consulta Crediti dell'account di fatturazione e Fatturazione.

Cloud SDK

gcloud projects create "PROJECT"

Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

• gcloud projects create

Nota: se non prevedi di conservare le risorse che crei in un esercizio di apprendimento, crea un progetto anziché selezionarne uno esistente. Al termine dell'esercizio, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

Passaggio 2

Per utilizzare Google Maps Platform, devi abilitare le API o gli SDK che prevedi di utilizzare con il tuo progetto.

Console

Attivare l'API Maps Embed

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

• gcloud services enable
• gcloud services disable

Passaggio 3

Questo passaggio passa solo attraverso il processo di creazione della chiave API. Se utilizzi la chiave API in produzione, ti consigliamo vivamente di limitare la chiave API. Puoi trovare ulteriori informazioni nella pagina Utilizzo delle chiavi API specifica del prodotto.

La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto per scopi di utilizzo e fatturazione. Devi avere almeno una chiave API associata al tuo progetto.

Per creare una chiave API:

Console

1. Vai alla pagina Google Maps Platform > Credenziali.

   Vai alla pagina Credenziali

2. Nella pagina Credenziali, fai clic su Crea credenziali > Chiave API.
   Nella finestra di dialogo Chiave API creata viene visualizzata la chiave API appena creata.
3. Fai clic su Chiudi.
   La nuova chiave API è elencata nella sezione Chiavi API della pagina Credenziali.
   Ricorda di limitare la chiave API prima di utilizzarla in produzione.

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

• gcloud alpha services api-keys create

Generazione di un iframe

Fai clic sulle opzioni seguenti e aggiungi una posizione e una chiave API per generare un iframe per la tua pagina web. Per ulteriori opzioni e parametri, consulta Incorporare una mappa.

Test dell'iframe

Per visualizzare l'iframe in una finestra del browser HTML:

1. Apri l'editor di testo predefinito. Sul tuo dispositivo dovrebbero essere installati per impostazione predefinita editor di testo come TextEdit o Microsoft Windows Notepad.
2. Crea un file HTML e assegnagli il nome index.html.

3. Aggiungi il seguente codice con l'iframe generato sopra:

   <html>
     <!-- Replace this code comment with your iframe. -->
   </html>
   

4. Salva il file HTML index.html.

5. Carica il file HTML in un browser web trascinandolo dal desktop nel browser. In alternativa, puoi fare doppio clic sul file nella maggior parte dei sistemi operativi.

Congratulazioni! Hai appena configurato e creato una mappa utilizzando l'API Maps Embed.

Eseguire la pulizia

Puoi eliminare il tuo progetto Google Cloud per interrompere la fatturazione per tutte le risorse utilizzate all'interno del progetto.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• Tutto ciò che è presente nel progetto viene eliminato. Se hai utilizzato un progetto esistente per questo tutorial, quando lo elimini, eliminerai anche qualsiasi altro lavoro eseguito nel progetto.
• Gli ID progetto personalizzati sono andati persi. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

1. In Google Cloud Console, vai alla pagina Gestisci risorse:

   Vai alla pagina Gestisci risorse

2. Se il progetto che intendi eliminare è collegato a un'organizzazione, seleziona ed espandi l'elenco delle organizzazioni nella parte superiore della pagina.
3. Nell'elenco dei progetti, seleziona quello che vuoi eliminare e fai clic su Elimina.
4. Nella finestra di dialogo, digita l'ID progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Inizia a sviluppare con l'API Maps Embed impostando il tuo progetto Google Cloud:

  Configura nella console Cloud

• Per un elenco di ulteriori parametri e opzioni che puoi aggiungere nell'iframe, procedi nel seguente modo:

  Incorporare una mappa

• Estendi il tuo progetto Maps con l'API JavaScript:

  API Maps JavaScript