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.

Artikel Erstellt Aktualisiert Auch auf Englisch: A GDPR-Compliant Google Maps Embed

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:

  1. Vor dem Klick kein Request an Google. Keine Karte, keine Kachel, gar nichts.
  2. Echte Einwilligung. Der Klick auf „Einmalig anzeigen“ oder „Zustimmen und merken“ ist die Zustimmung (Art. 6 Abs. 1 lit. a DSGVO).
  3. 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' statt strict-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) neben yt-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.com gibt 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. lat und lng bauen 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.

In der Graph-Ansicht zeigen