Guida rapida dell'API Maps Embed

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

Costi

Tutte le richieste dell'API Maps Embed sono disponibili senza costi e con utilizzo illimitato. Tuttavia, tutte le richieste richiedono comunque una chiave API Google Cloud valida. Per ulteriori informazioni, vedi 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 di selezione del progetto, fai clic su Crea progetto per iniziare a creare un nuovo progetto Cloud.

    Vai alla pagina del selettore dei progetti

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

    Google Cloud offre una prova senza costi. La prova scade al termine di 90 giorni o dopo che l'account ha accumulato addebiti per un valore di 300 $, 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 ulteriori 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 attivare 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 riguarda solo la procedura di creazione della chiave API. Se utilizzi la chiave API in produzione, ti consigliamo vivamente di limitarla. Puoi trovare altre informazioni nella pagina Utilizzo di chiavi API specifica del prodotto.

La chiave API è un identificatore univoco che autentica le richieste associate al progetto a fini di utilizzo e fatturazione. Devi avere almeno una chiave API associata al 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 seguenti opzioni e aggiungi una località e una chiave API per generare un iframe per la tua pagina web. Per altri parametri e opzioni, vedi Incorporare una mappa.

Testare l'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 all'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 sul browser. In alternativa, puoi fare doppio clic sul file sulla maggior parte dei sistemi operativi.

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

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 è associato a un'organizzazione, seleziona ed espandi l'elenco delle 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