Guida rapida dell'API Maps Embed

Inserisci una mappa interattiva o una panoramica in Street View nella tua pagina web con una semplice richiesta HTTP, senza utilizzare JavaScript.

Costi

Tutte le richieste API Maps Embed sono disponibili senza costi aggiuntivi con 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 la procedura di configurazione richiesta 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 tuo progetto.

    Google Cloud offre una prova con addebito di 0,00 $. La prova scade al termine dei 90 giorni o dopo che l'account ha accumulato addebiti per 300 $, 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:

Passaggio 2

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

Console

Abilita 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:

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 per il 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.
    La finestra di dialogo Chiave API creata mostra la chiave API appena creata.
  3. Fai clic su Chiudi.
    La nuova chiave API è elencata nella pagina Credenziali in Chiavi API.
    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:

Generazione di un iframe

Fai clic sulle opzioni riportate di seguito e aggiungi una posizione e una chiave API per generare un iframe per la 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. Dovresti avere editor di testo come TextEdit o Microsoft Windows Notepad installati sul dispositivo per impostazione predefinita.
  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, il doppio clic sul file funziona nella maggior parte dei sistemi operativi.

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

esegui la pulizia

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

  1. Nella console Google Cloud, 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 Arresta per eliminare il progetto.

Passaggi successivi