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
regionaccetta 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
- Servizio da attivare:
maps-embed-backend.googleapis.com - Autenticazione: chiave API
- Per iniziare: configura l'API Maps Embed
- Riferimento: Riferimento API Maps Embed
- Prezzi: utilizzo e fatturazione dell'API Maps Embed
API Maps Embed: errori comuni
- Problema: se la pagina host imposta un meta tag
referrersuno-referrerosame-origin, il browser non invia l'intestazioneReferere una chiave API con limitazioni per referrer HTTP può rifiutare le richieste di incorporamento. Correzione: aggiungireferrerpolicy="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
widtheheightdell'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.