Meine Adressen haben noch keine Geo-Koordinaten, kann ich diese automatisch ermitteln?

Überblick

Ja. Mit der Pro-Version der Erweiterung Address-Manager kannst Du fehlende Geo‑Koordinaten (Breiten‑/Längengrad) automatisch per Google‑Maps Geocoding API ermitteln. Dafür bringt die Pro‑Erweiterung einen Konsolen‑Befehl mit, der Deine Adressen durchgeht und die Koordinaten setzt.

Voraussetzungen

• Address‑Manager‑Pro ist installiert und aktiviert.
• Ein gültiger Google‑Cloud API‑Key für die Geocoding API ist vorhanden (Abrechnung in Google Cloud muss aktiviert sein).
• Die Adressfelder sind sinnvoll befüllt (z. B. Straße, PLZ, Ort, Land), damit die Suche eindeutige Ergebnisse liefert.

Nutzung per CLI

Der Befehl wird über die TYPO3 Konsole ausgeführt:

vendor/bin/typo3 address_manager_pro:geocoding --apiKey="<DEIN_API_KEY>" [--useFields="address,postal_code,city,country"] [--limit=<ANZAHL>]

Kurzoptionen:

• -a entspricht --apiKey
• -f entspricht --useFields
• -l entspricht --limit

Optionen im Detail

• --apiKey (Pflicht): Dein Google‑Geocoding‑API‑Key.
• --useFields (optional, Default: address,postal_code,city,country): Kommagetrennte Liste der Adressfelder, die zur Suchanfrage zusammengesetzt werden. Passe das an, wenn Du z. B. region/Bundesland mitgeben möchtest.
• --limit (optional): Begrenzt die Anzahl der zu verarbeitenden Datensätze. 0 bedeutet „alle“.

Beispiele

• Alle Adressen ohne Koordinaten verarbeiten:

  vendor/bin/typo3 address_manager_pro:geocoding -a "AIza..."

• Nur die ersten 50 Datensätze prüfen:

  vendor/bin/typo3 address_manager_pro:geocoding -a "AIza..." -l 50

• Eigene Feldreihenfolge verwenden (z. B. mit Bundesland):

  vendor/bin/typo3 address_manager_pro:geocoding -a "AIza..." -f "address,postal_code,city,region,country"

Ergebnis

Der Befehl ermittelt für jede Adresse ohne Koordinaten die Werte und speichert sie in den Feldern map_latitude und map_longitude. In der Ausgabe siehst Du, wie viele Adressen verarbeitet wurden und ob Treffer gespeichert werden konnten.

Tipps & Hinweise

• Präzision erhöhen: Je genauer die verwendeten Felder sind (Straße + Hausnummer, PLZ, Ort, Land), desto besser die Ergebnisse.
• Rate Limits beachten: Die Google‑API hat Kontingente. Bei größeren Datenmengen ggf. in mehreren Läufen mit --limit arbeiten.
• Protokoll/Debug: Der Befehl gibt für jede Adresse eine kurze Info aus. Achte auf Fehlermeldungen (z. B. fehlende Felder), um Datenqualität zu verbessern.

Fehlerbehebung

• „No API Key given“: Option --apiKey wurde nicht gesetzt.
• „Address can't be found“: Prüfe die verwendeten Felder (--useFields) und die Datenqualität (Straße/PLZ/Ort/Land). Ergänze fehlende Felder und starte den Befehl erneut.
• Keine Updates sichtbar: Es werden nur Adressen ohne Koordinaten verarbeitet. Entferne testweise vorhandene Werte oder nutze neue Datensätze.