Riferimento rapido dell'API Maps Embed

L'API Maps Embed inserisce una mappa interattiva o una panoramica in Street View in una pagina web tramite una richiesta HTTP impostata come URL iframe src, senza richiedere JavaScript. Supporta le modalità mappa place, view, directions, streetview e search.

API Maps Embed: informazioni chiave

  • Prodotto: API Maps Embed
  • Nota anche come: API Google Maps Embed, Maps Embed
  • Category: Maps
  • Piattaforma: JavaScript (browser)
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica dell'API Maps Embed
  • Disponibilità regionale: ovunque. La modalità Street View dipende dalla copertura di Street View; il parametro region accetta le regioni elencate nella pagina dei dettagli della copertura di Maps Platform. (dettagli sulla copertura)

API Maps Embed: quando utilizzarla

Utilizza l'API Maps Embed quando:

  • Hai bisogno di una mappa interattiva o di una panoramica in Street View su una pagina web utilizzando solo un iframe HTML, senza JavaScript.
  • Devi mostrare un segnaposto di un luogo, una visualizzazione mappa, le indicazioni stradali tra punti o i risultati di ricerca per un'area in una mappa incorporata.
  • Hai bisogno di una mappa incorporata senza costi per richiesta e senza limiti di QPS o di richieste giornaliere (è comunque necessaria una chiave API).

Non utilizzare l'API Maps Embed quando:

  • Devi personalizzare una mappa web con i tuoi contenuti e le tue immagini. Utilizza invece l'API Maps JavaScript.
  • Devi estendere una mappa incorporata con funzionalità di programmazione oltre i parametri URL dell'iframe. Utilizza invece l'API Maps JavaScript.

API Maps Embed: configurazione

API Maps Embed: errori comuni

  • Problema: se la pagina host imposta un meta tag referrer su no-referrer o same-origin, il browser non invia l'intestazione Referer e una chiave API con limitazioni per referrer HTTP può rifiutare le richieste di incorporamento. Correzione: aggiungi referrerpolicy="strict-origin-when-cross-origin" all'iframe in modo che il dominio del sito venga inviato a Google. Consulta /maps/documentation/embed/embedding-map.
  • Problema: le mappe incorporate non sono supportate se hanno dimensioni inferiori a 200 px. Correzione: imposta width e height dell'iframe su almeno 200 px. Consulta /maps/documentation/embed/embedding-map.
  • Problema: anche se l'utilizzo è senza costi, viene visualizzata una mappa oscurata con la filigrana"solo per scopi di sviluppo" se la fatturazione non è abilitata, il metodo di fatturazione non è valido, viene superato un limite giornaliero autoimposto o la richiesta non contiene un referrer HTTP mentre utilizzi una chiave con limitazioni per i referrer. Correzione: abilita la fatturazione con un metodo di pagamento valido nel progetto, aumenta o rimuovi qualsiasi limite di quota giornaliera autoimposto e assicurati che il referrer venga inviato per le chiavi con limitazioni per referrer (ad esempio con referrerpolicy="strict-origin-when-cross-origin" nell'iframe). Consulta la pagina /maps/documentation/embed/error-messages.
  • Problema: per le richieste non valide (parametri errati o mancanti ed errori relativi alla chiave API e alla quota, ad esempio una chiave mancante o non valida, l'API Maps Embed non abilitata o una violazione della limitazione della chiave), nella console del browser viene segnalato solo il codice di stato HTTP 4xx, non un messaggio descrittivo; il testo dell'errore viene visualizzato all'interno dell'iframe al posto della mappa. Correzione: leggi il testo dell'errore nell'iframe e il codice di stato della console (400 per errori dei parametri, 401 per una chiave mancante, 403 per una chiave non valida), quindi verifica che i parametri siano validi, che la chiave sia valida, che l'API Maps Embed sia abilitata e che le restrizioni della chiave consentano la richiesta. Consulta la pagina /maps/documentation/embed/error-messages.

Cosa puoi fare con l'API Maps Embed

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.

API Maps Embed: indicazioni stradali e routing

API Maps Embed: Maps

API Maps Embed: Places

API Maps Embed: Street View