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 bisogno di JavaScript.

Costi

Tutte le richieste all'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 i passaggi di configurazione richiesti facendo clic sulle seguenti schede:

Passaggio 1

Console

  1. Nella console Google Cloud, nella pagina del selettore dei progetti, 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 dopo 90 giorni o dopo che l'account ha accumulato 300 $di addebiti, a seconda dell'evento che si verifica per primo. Puoi annullare in qualsiasi momento. Google Maps Platform offre un credito mensile ricorrente di 200 $. Per maggiori informazioni, vedi Crediti dell'account di fatturazione e Fatturazione.

Cloud SDK

gcloud projects create "PROJECT"

Scopri di più su Google Cloud SDK , 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 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 , installazione di Cloud SDK e sui seguenti comandi:

Passaggio 3

Questo passaggio esegue solo la procedura di creazione della chiave API. Se utilizzi la chiave API in produzione, ti consigliamo vivamente di limitarla. Per ulteriori informazioni, consulta la pagina Utilizzo delle chiavi API specifica del prodotto.

La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto ai fini 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 è indicata nella pagina Credenziali, nella sezione 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 , installazione di Cloud SDK e sui seguenti comandi:

Generazione di un iframe

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

Test dell'iframe

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

  1. Apri l'editor di testo predefinito. Sul dispositivo dovrebbero essere installati editor di testo come TextEdit o Microsoft Windows Notepad 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 al 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 del progetto.

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse:

    Vai alla pagina Gestisci risorse

  2. Se il progetto che intendi eliminare è associato a un'organizzazione, seleziona ed espandi l'elenco di organizzazioni nella parte superiore della pagina.
  3. Nell'elenco dei progetti, seleziona il progetto 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