Google Maps DSGVO-konform einbetten
Eine Astro-Komponente, die Google Maps erst nach Zustimmung lädt, die Entscheidung in localStorage merkt und aus Koordinaten Links zu Google und Apple Maps baut.
Geprüft von adrian
am
Gleiche Lage wie bei der YouTube-Einbettung: Ein normaler <iframe src="google.com/maps/embed/…"> schickt beim Seitenaufruf sofort Daten an Google. IP-Adresse, Browser-Fingerprint, Cookies, alles ohne Zustimmung. Für eine öffentliche Website ist das ein DSGVO-Problem.
Was ich brauchte:
- Vor dem Klick kein Request an Google. Keine Karte, keine Kachel, gar nichts.
- Echte Einwilligung. Der Klick auf „Einmalig anzeigen“ oder „Zustimmen und merken“ ist die Zustimmung (Art. 6 Abs. 1 lit. a DSGVO).
- App-Links. Wer den Ort lieber direkt in Google Maps oder Apple Maps öffnet, kann das auch ohne den iframe.
Verwendung
src/components/GoogleMapsEmbed.astro braucht nur Koordinaten und einen Namen:
<GoogleMapsEmbed
lat={7.8807048}
lng={98.3657287}
title="Naka Weekend Market, Phuket"
/>
Die Komponente baut die Embed-URL und alle App-Links aus den Koordinaten.
| Prop | Typ | Pflicht | Beschreibung |
|---|---|---|---|
lat |
number | ja (oder src) |
Breitengrad |
lng |
number | ja (oder src) |
Längengrad |
title |
string | nein | Ortsname (Beschriftung und App-Links) |
src |
string | ja (oder lat + lng) |
Von Hand gebaute Embed-URL |
href |
string | nein | Überschreibt den Google-Maps-Link |
zoom |
number | nein | Zoomstufe (Standard 15) |
Das Template
<figure class="maps-embed">
{title && <figcaption class="maps-caption">{title}</figcaption>}
<div class="maps-consent" data-src={src} data-title={title ?? ''}>
<h3>{t(locale, 'maps.externalContent')}</h3>
<p>{t(locale, 'maps.description')}</p>
<p>{t(locale, 'maps.serviceName')}</p>
<div class="maps-consent-buttons">
<button data-remember="true">{t(locale, 'maps.loadMapRemember')}</button>
<button>{t(locale, 'maps.loadMap')}</button>
</div>
<p class="maps-consent-footer">
{t(locale, 'maps.consentFooter')}
<a href={privacyHref}>{t(locale, 'maps.privacyLink')}</a>.
</p>
</div>
<div class="maps-actions">
<a href={googleMapsHref}>Google Maps</a>
{appleMapsHref && <a href={appleMapsHref}>Apple Maps</a>}
</div>
</figure>
Die Leiste maps-actions mit den App-Links liegt außerhalb von .maps-consent. Sie bleibt sichtbar, egal ob die Karte geladen ist. (Im Original stand vor beiden Links ein Pin-Emoji.)
Das Skript
<script>
const CONSENT_KEY = 'gmaps-consent';
function buildIframe(src, title) {
const iframe = document.createElement('iframe');
iframe.src = src;
iframe.allow = 'fullscreen';
iframe.loading = 'lazy';
iframe.referrerPolicy = 'no-referrer-when-downgrade';
iframe.style.cssText = 'width:100%;aspect-ratio:4/3;border:0;display:block';
if (title) iframe.title = title;
return iframe;
}
const hasConsent = (() => {
try { return localStorage.getItem(CONSENT_KEY) === '1'; } catch { return false; }
})();
document.querySelectorAll('.maps-consent').forEach((container) => {
const { src, title } = container.dataset;
if (!src) return;
if (hasConsent) { container.replaceWith(buildIframe(src, title)); return; }
container.querySelectorAll('button').forEach((btn) => {
btn.addEventListener('click', () => {
if (btn.dataset.remember === 'true') {
try { localStorage.setItem(CONSENT_KEY, '1'); } catch {}
}
container.replaceWith(buildIframe(src, title));
});
});
});
</script>
Zwei Unterschiede zum YouTube-Skript:
referrerPolicy = 'no-referrer-when-downgrade'stattstrict-origin-when-cross-origin. Google Maps braucht den vollen Referrer (Protokoll und Domain), scheitert aber nicht wie YouTube an einem fehlenden Pfad.- Ein eigener
CONSENT_KEY(gmaps-consent) nebenyt-consent. Es sind verschiedene Dienste. Wer YouTube freigegeben hat, muss für Maps getrennt zustimmen.
Koordinaten
// Auto-build src from coordinates if not provided
if (!src && lat != null && lng != null) {
src = `https://maps.google.com/maps?q=${lat},${lng}&output=embed&zoom=${zoom}`;
}
// Apple Maps URL
const appleMapsHref = lat && lng
? `https://maps.apple.com/?ll=${lat},${lng}&q=${encodeURIComponent(title ?? '')}`
: title
? `https://maps.apple.com/?q=${encodeURIComponent(title)}`
: null;
Fehlen die Props lat und lng, liest die Komponente die Koordinaten aus der src-URL (Format ?q=lat,lng).
Texte
Neue Keys in src/i18n/ui.ts:
'maps.externalContent': 'Externer Inhalt',
'maps.description': 'An dieser Stelle findest du eine interaktive Karte von Google Maps.',
'maps.serviceName': 'Google Maps (maps.google.com)',
'maps.loadMap': 'Einmalig anzeigen',
'maps.loadMapRemember': 'Zustimmen und merken',
'maps.openInMaps': 'In Google Maps öffnen',
'maps.consentFooter': 'Ich bin damit einverstanden, …',
'maps.privacyLink': 'Datenschutzerklärung',
Die CSP anpassen
Google Maps braucht zwei zusätzliche Einträge in frame-src der CSP in Caddy:
- frame-src https://www.youtube-nocookie.com;
+ frame-src https://www.youtube-nocookie.com https://maps.google.com https://www.google.com;
Was anders ist als bei YouTube
- Kein Datenschutzmodus. Ein Gegenstück zu
youtube-nocookie.comgibt es für Maps nicht. Die Einwilligungsbox ist der einzige Schutz, bevor die Karte lädt. - App-Links immer sichtbar. Google Maps und Apple Maps funktionieren als Ausweg auch ohne den iframe.
- Koordinaten zuerst.
latundlngbauen alles, keine Embed-URL muss von Hand zusammengesetzt werden.
Am Ende des Beitrags stand eine Live-Demo zum Naka Weekend Market auf Phuket: die Einwilligungsbox mit ihren zwei Buttons und darunter die beiden App-Links.
Beruht auf
-
Google Maps DSGVO-konform einbetten: Consent-Box mit App-Links
(
raw/2026/2026-04-25/google-maps-dsgvo-konform-einbetten-consent-box-mit-app-links.md) [post]
Mehr dazu
Thema
- Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.
- Webentwicklung Wie diese und andere Websites entstehen und gefunden werden: statische Seiten, Suchmaschinen, IndieWeb und Karten im Browser.
Baut auf
- YouTube DSGVO-konform einbetten Eine Astro-Komponente, die YouTube erst nach einem Klick lädt: einmalig, zustimmen und merken oder nur der Link. Kein Cookie, kein Request an Google vorher.
Nutzt
- Caddy Webserver und Reverse Proxy, der TLS-Zertifikate selbst holt und erneuert, eingerichtet in einem kurzen Caddyfile.
Im Text erwähnt
- Security-Header in Caddy Eine strikte Content Security Policy, HSTS und no-referrer in einem Caddy-Siteblock, geprüft mit Webbkoll, securityheaders.com und dem Mozilla Observatory.