Google Maps API Keys erstellen
WP-ImmoMakler benötigt zwei separate Google Maps API Keys: einen serverseitigen Key für Hintergrundoperationen und einen browserseitigen Key für die Kartenanzeige auf Ihrer Website.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“Für die Nutzung der Google Maps APIs ist ein Google-Konto mit einem verknüpften Abrechnungskonto erforderlich. Google verlangt die Hinterlegung einer Kontoverbindung oder Kreditkarte, selbst wenn Sie das kostenlose Kontingent nicht überschreiten. Erfahrungsgemäß bleiben auch Makler*innen mit mehreren hundert Immobilien und hohem Website-Traffic innerhalb des monatlichen Freikontingents, sodass in der Regel keine zusätzlichen Kosten anfallen.
Key 1: Serverseitiger API Key
Abschnitt betitelt „Key 1: Serverseitiger API Key“Dieser Key wird für folgende Funktionen verwendet:
- Automatische Geokodierung von Immobilienstandorten (Geocoding API)
- Karten in der PDF-Druckansicht (Maps Static API)
- Adress-Autovervollständigung im Backend (Places API)
Einzurichtende APIs:
Einschränkung: Beschränken Sie diesen Key auf die IP-Adresse Ihres Servers. Die IP-Adresse Ihres Servers wird Ihnen direkt in den WP-ImmoMakler-Einstellungen angezeigt.
Key 2: Browserseitiger API Key (JavaScript API Key)
Abschnitt betitelt „Key 2: Browserseitiger API Key (JavaScript API Key)“Dieser Key wird für folgende Funktionen verwendet:
- Kartenanzeige auf Ihrer Website (Maps JavaScript API)
- Adress-Autovervollständigung im Suchformular (Places API)
Einzurichtende APIs:
Einschränkung: Beschränken Sie diesen Key auf HTTP-Referrer, also auf die Domain(s) Ihrer Website. Fügen Sie am Ende der Domain ein Wildcard-Sternchen hinzu, damit alle Unterseiten korrekt funktionieren, zum Beispiel: https://www.ihre-website.de/*
Warum zwei separate Keys?
Abschnitt betitelt „Warum zwei separate Keys?“Der browserseitige Key ist im Quellcode Ihrer Website öffentlich sichtbar. Aus Sicherheitsgründen sollten API Keys deshalb eingeschränkt werden, damit keine Dritten auf Ihre Kosten die Keys verwenden können. Ein einzelner API Key lässt sich jedoch entweder auf IP-Adressen oder auf Domainnamen einschränken, nicht beides gleichzeitig. Da die Geocoding- und Static-Maps-APIs vom Server aufgerufen werden (Einschränkung auf Server-IP), die JavaScript- und Places-APIs aber aus dem Browser Ihrer Besucher*innen (Einschränkung auf Referrer-Domain), benötigen Sie zwei unterschiedliche Keys.
API Keys in WP-ImmoMakler hinterlegen
Abschnitt betitelt „API Keys in WP-ImmoMakler hinterlegen“Tragen Sie die erstellten Keys im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → Google Maps ein. Den serverseitigen Key in das Feld für den Geocoding-Key, den browserseitigen Key in das Feld für den JavaScript-Key.
Sollten Sie Probleme mit der Einrichtung der Keys haben, wenden Sie sich gerne an unseren Support. Gerne können wir die Keys per Screen-Sharing gemeinsam einrichten.
Speicherort des Fast-API-Proxys für die Adressvervollständigung
Abschnitt betitelt „Speicherort des Fast-API-Proxys für die Adressvervollständigung“Damit die Adressvervollständigung in der Umkreissuche schnell reagiert, legt WP-ImmoMakler ein kleines PHP-Skript (immomakler-autocomplete.php) auf Ihrer Website ab. Das Skript nimmt die Eingabe aus dem Suchformular entgegen, leitet sie serverseitig an die Google Places API (New) weiter und gibt die Vorschläge zurück – ohne den vollständigen WordPress-Kern zu laden. Dadurch ist die Vorschlagsliste deutlich schneller, und der Google Maps API Key bleibt ausschließlich auf dem Server und wird nicht an den Browser gesendet.
Standard: wp-content/cache/immomakler/fast-api/immomakler-autocomplete.php
Zusammen mit dem Skript wird eine Datei .immomakler-autocomplete-secrets.php abgelegt, in der der Google Maps API Key, die erlaubten Herkunfts-URLs sowie die konfigurierten Länder und das Suchgebiet stehen. Beide Dateien werden automatisch bei jeder Änderung der entsprechenden Einstellungen aktualisiert.
Einstellung: Speicherort Fast-API-Proxy
Abschnitt betitelt „Einstellung: Speicherort Fast-API-Proxy“Im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → Google Maps finden Sie die Einstellung Adressvervollständigung Umkreissuche: Speicherort Fast-API-Proxy. Zur Auswahl stehen:
- wp-content (Standard) – die Dateien liegen unter
wp-content/cache/immomakler/fast-api/. Empfohlen für alle neuen Installationen. - Stammverzeichnis – die Dateien liegen direkt neben der
wp-config.php. Fallback für Installationen, in denen eine Sicherheits-Erweiterung wie Wordfence oder iThemes Security die Ausführung von PHP-Dateien unterhalb vonwp-content/blockiert.
Wenn die Adressvervollständigung in der Umkreissuche nicht reagiert (leere Vorschlagsliste) und das Plugin auch nach dem Laden der Seite keine Verbindung zum Fast-API-Proxy herstellen kann, ist in der Regel das Ausführen von PHP-Dateien im wp-content/-Verzeichnis durch eine Sicherheits-Erweiterung unterbunden. In diesem Fall wechseln Sie die Einstellung auf Stammverzeichnis. Die Umkreissuche funktioniert unabhängig davon weiterhin – WP-ImmoMakler nutzt die regulären WordPress-Schnittstellen (REST API und admin-ajax) als automatische Fallback-Option, diese Wege sind jedoch etwas langsamer.
Multisite-Netzwerke
Abschnitt betitelt „Multisite-Netzwerke“In WordPress-Multisite-Netzwerken wird aus Sicherheitsgründen immer der Speicherort wp-content verwendet und kann nicht auf das Stammverzeichnis umgestellt werden. Jede Website im Netzwerk erhält einen eigenen Unterordner (z. B. wp-content/cache/immomakler/fast-api/2/ für die Website mit der Blog-ID 2), sodass jede Website mit einem eigenen Google Maps API Key, eigenen Länderauswahlen und einem eigenen Suchgebiet arbeiten kann. Das Stammverzeichnis steht allen Websites des Netzwerks gemeinsam zur Verfügung – eine Ablage der Zugangsdaten dort würde daher dazu führen, dass alle Websites denselben API Key nutzen, was in Multisite-Setups mit unterschiedlichen Inhabern nicht erwünscht ist.
Fehlermeldungen im Backend
Abschnitt betitelt „Fehlermeldungen im Backend“„Places API (New) nicht aktiviert”
Abschnitt betitelt „„Places API (New) nicht aktiviert”“Zeigt WP-ImmoMakler im Backend Ihrer Website (wp-admin) den Hinweis „WP-ImmoMakler: Places API (New) nicht aktiviert”, ist die Places API (New) für Ihren Google Server API-Key entweder nicht in der Google Console aktiviert oder nicht unter den API-Einschränkungen des Keys ausgewählt. Die Adress-Autovervollständigung der Umkreissuche funktioniert in diesem Fall nicht.
Behebung:
- Öffnen Sie die Places API (New) in der Google Console und aktivieren Sie die API für Ihr Projekt.
- Öffnen Sie unter API-Schlüssel den betroffenen Server API-Key und fügen Sie unter „API-Einschränkungen” die Places API (New) zur Liste der erlaubten APIs hinzu.
- Rufen Sie im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Integrationen → Google Maps die Einstellungsseite auf – WP-ImmoMakler testet den Key automatisch beim Laden der Seite. War der Test erfolgreich, verschwindet der Hinweis.