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.
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.
- Schlagwörter