KFZ-Bozo Handbuch

Schnittstellen, API & Automationen › Google Bewertungen (Places API)

Google Bewertungen (Places API)

IntegrationUnklar✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)

Die Bewertungen-Sektion der Website kann echte, aktuelle Google-Bewertungen anzeigen. Solange kein Google-Zugang eingerichtet ist, zeigt sie stattdessen von Hand gepflegte Platzhalter-Bewertungen.

KundeBüro

Bild folgt

Beim Seitenaufruf prüft die Website, ob ein Google-Zugang eingerichtet ist. Ist er es, holt sie einmal täglich aktuelle Bewertung, Sternedurchschnitt und Rezensionstexte vom Google-Unternehmensprofil und hält sie 24 Stunden im Zwischenspeicher, um Kosten und Ladezeit gering zu halten. Fehlt der Zugang, meldet der Code einen Fehler oder findet das Unternehmensprofil nicht, springt die Seite ohne sichtbaren Fehler auf handkuratierte Platzhalter-Bewertungen um — der Zugangsschlüssel selbst bleibt dabei serverseitig und erreicht nie den Browser der Besucher.

  • Bewertungen wirken veraltet oder unverändert → normal, sie werden nur einmal täglich neu geholt.
  • Bewertungen sehen aus wie Platzhalter statt echter Rezensionen → der Google-Zugang ist nicht eingerichtet oder das Unternehmensprofil konnte nicht gefunden werden; die Seite bleibt trotzdem funktionsfähig.

Speist

Gebraucht vo…SpeistLiestGoogle Bew…Umgebungsvaria…Öffentliche We…Kunden- & Auft…
  • Ist GOOGLE_PLACES_API_KEY in der Prod-.env tatsächlich gesetzt? Nicht direkt geprüft, nur der Fallback-Mechanismus im Code.
  • lib/google-places.ts
  • .env.example
  • MEM:reviews-data-source.md
richtungeingehend
daten_die_das_haus_verlassennur eine Suchanfrage mit Betriebsname und Adresse, serverseitig — keine Kunden-PII geht an Google
verarbeiterunklar — ja, sobald der Zugang gesetzt ist (Google als Cloud-Dienst); ohne Zugang läuft alles lokal über die Platzhalterdaten
zustaendigBüro
kostennutzungsabhängig (Google Cloud Places API), durch 24-Stunden-Cache pro Aufruf gering gehalten
vertragGoogle-Cloud-Konto nötig, Vertragspartner/Owner nicht recherchiert
ohneBewertungen-Sektion zeigt handkuratierte Platzhalter, kein Fehler sichtbar
ausloeseruser action (Seitenaufruf, 24h gecached)
envVarsGOOGLE_PLACES_API_KEY, GOOGLE_PLACE_ID, GOOGLE_PLACE_QUERY
status_prodnicht aus Memory bestätigbar — kein Live-Nachweis gefunden, Code fällt bei fehlendem Zugang sauber auf statische Platzhalter zurück, wirkt daher eher unauffällig, ob live oder Fallback
kosten_vertragGoogle Cloud Console, Places API (New) — nutzungsabhängige Kosten, Konto-Owner nicht recherchiert
datenkeine Kunden-PII, öffentliche Bewertungstexte/Sternebewertung

Beleg: lib/google-places.ts:21-23 (liest GOOGLE_PLACES_API_KEY, fällt ohne Wert auf data/reviews.json zurück); .env.example (Key als leer vorgegeben); kein Treffer in memory/*.md außer reviews-data-source.md (nur zum statischen Fallback, nicht zum Live-Status)

Schnittstellen, API & AutomationenSeite bearbeiten: wiki/seiten/schnittstellen-automation/int-google-places.md