Betrachter der Aufnahme

Der Ingestion Viewer (im Actions Center unter Aufnahme > Verlauf verfügbar) bietet nahezu in Echtzeit Einblick in den Status, die Validierung und den Verarbeitungsvorgang von Feeds für lokale POIs.

Mit dem Ingestion Viewer können Sie tägliche Feed-Uploads nachverfolgen, den Status der Aufnahme überwachen, Statistiken zu Validierungsfehlern auf Artikelebene prüfen und den Eingang von Feed-Dateien bestätigen.

Übersicht

Auf der Hauptseite des Ingestion Viewer wird ein Log aller von Google empfangenen Feeds in umgekehrter chronologischer Reihenfolge angezeigt.

Phasen des Aufnahmelebenszyklus

Jede Feedeinreichung durchläuft die folgenden sequenziellen Verarbeitungsphasen:

  1. Dateiabruf:Google empfängt die Feeddatei über SFTP.
  2. Dateivalidierung:Das System prüft die Dateiintegrität, die Dekomprimierung und das allgemeine Schemaformat.
  3. Entitätsextraktion und ‑validierung:In der Pipeline werden einzelne lokale Datensätze (poi_id, Adresse, Koordinaten, Lokalisierungen) geparst und auf Syntax, Vollständigkeit und Richtlinienkonformität geprüft.
  4. Abstimmung und Abgleich:Gültige Entitäten werden an die Abgleichs-Engine von Google übergeben, um sie mit primären Google-Orts-IDs für die Auslieferung zu verknüpfen.
  5. Berichterstellung:Zusammenfassende Messwerte und gruppierte Problemdiagnosen werden im Ingestion Viewer veröffentlicht.

So rufen Sie den Verlauf der Feedaufnahme auf:

  1. Melden Sie sich im Actions Center an.
  2. Öffnen Sie die Seite Aufnahme > Verlauf.
  3. Mit den Spaltensteuerelementen können Sie die Aufnahmetabelle filtern, sortieren und ansehen.

Spalten der Aufnahmeliste

Die Hauptzusammenfassungstabelle enthält die folgenden Spalten für jeden Erfassungslauf:

Spalte Datentyp Beschreibung
ID String Eindeutige Kennung für den Importvorgang.
Ingested time (UTC) (Aufnahmezeit (UTC)) Timestamp Datum und Uhrzeit (in UTC), zu der Google mit der Verarbeitung der Feedaufnahme begonnen hat.
Aufnahmetyp Enum Art der Datenerfassung (z.B. Feed).
Name String Name für die Art der Feedaufnahme. Das ist google.local_vss.
Status State Der allgemeine Verarbeitungsstatus der Aufnahme (z.B. „Abgeschlossen“, „Fehlgeschlagen“). Statusdefinitionen
Verhalten bei der Aufnahme Enum Alle lokalen POI-Feeds werden im Batch-Modus verarbeitet.
Fehler Integer Gesamtzahl der erkannten Validierungsprobleme auf Blockierungsebene.
Warnungen Integer Gesamtzahl der erkannten nicht blockierenden Probleme auf Warnstufe.
Elemente Integer Gesamtzahl der lokalen Immobilien, die bei dieser Aufnahme verarbeitet wurden.

Statusdefinitionen

In der Spalte Status wird der aktuelle Betriebsstatus einer Feedübermittlung angezeigt:

  • Abgeschlossen (STATUS_COMPLETE): Der Feed wurde ohne schwerwiegende Fehler erfolgreich aufgenommen, validiert und verarbeitet.
  • Fehlgeschlagen (STATUS_FAILED): Beim Import sind schwerwiegende Schema-, Dateibeschädigungs- oder Pipelinefehler aufgetreten und der Vorgang konnte nicht abgeschlossen werden.
  • Wird verarbeitet (STATUS_PROCESSING): Google validiert, gleicht die Feeddaten ab und speichert sie.
  • Übersprungen (NOT_STARTED): Der Feed-Upload wurde übersprungen, z. B. wenn der Zeitstempel der Generierung älter ist als der eines zuvor verarbeiteten Feeds.

Ansicht „Details zur Aufnahme“

Klicken Sie auf eine beliebige Zeile in der Tabelle „Ingestion Viewer“, um die Ingestion Details View (Ansicht mit Aufnahmedetails) zu öffnen. Diese Ansicht bietet umfassende Diagnosekarten und Aufklappbereiche zur Fehlerbehebung.

Detailbereiche

Die Seite „Aufnahmedetails“ ist in vier maximierbare Abschnitte unterteilt:

1. Allgemeine Informationen

Hier werden die wichtigsten Metadaten zum Ausführungsdurchlauf angezeigt:

  • Aufnahmezeit (UTC): Zeitstempel für den Beginn der Aufnahme durch Google.
  • Aufnahmetyp:Feed.
  • Name: google.local_vss
  • Aufnahmeverhalten:Batch
  • Status:Farbcodiertes Statussymbol (Done, Failed, Processing, Skipped).

2. Validierungen

Listet alle Validierungsergebnisse auf, die während der Aufnahme aufgetreten sind:

  • Dateifehler (Infobox): Wenn die gesamte Feeddatei fehlgeschlagen ist (z. B. aufgrund eines nicht lesbaren Archivs oder einer fehlerhaften JSON-Syntax), wird in einer auffälligen Warnung die Meldung zur Ursache angezeigt.
  • Probleme mit Entitäten (Akkordeontabelle): Validierungsprobleme auf Artikelebene, gruppiert nach Schweregrad und Fehlercode.
    • Problemcode:Spezifische Fehlerkennung (z. B. INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD oder SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Problembeschreibung:Eine Diagnosebeschreibung, in der die Ursache und die betroffenen Felder erläutert werden.
    • Datensätze:Die Gesamtzahl der Property-Entitäten, die von diesem Problem betroffen sind.
    • Klicken Sie auf eine beliebige Problemzeile, um Beispiel-Entitäts-IDs (poi_id) mit direkten Links zu maximieren, über die Sie die Eigenschaften im Inventar-Viewer prüfen können.

3. Elemente

Bietet Scorecards für Inventardelta auf Artikelebene für den Aufnahmevorgang:

  • Insgesamt:Gesamtzahl der verarbeiteten lokalen Eigenschaften.
  • Hinzugefügt:Anzahl der neu entdeckten Brancheneinträge, die Ihrem Katalog hinzugefügt wurden.
  • Geändert:Anzahl der vorhandenen Immobilien, deren Attribute (z.B. Name, Adresse, Koordinaten oder Bilder) aktualisiert wurden.
  • Entfernt:Anzahl der Properties, die im Vergleich zur vorherigen Feed-Baseline entfernt oder ausgelassen wurden.

4. Dateien

Zeigt den Namen der hochgeladenen Feeddatei an:

  • Dateiname:Name der Feeddatei (z. B. local_feed.json.gz).

Fehlerbehebung bei Aufnahmefehlern

Beachten Sie bei der Fehlerbehebung von Feeds in der Aufnahmeübersicht die folgenden Richtlinien:

Symptom Mögliche Ursache Empfohlene Maßnahme
Status ist Failed mit dem Fehler „Dateifehler“ Beschädigtes ZIP-/GZIP-Archiv, fehlerhafte JSON-Syntax oder nicht unterstützte Dateicodierung. Prüfen Sie anhand der Richtlinien für das Verpacken von Feeds, ob Ihr Feed richtig verpackt ist.
Hohe AnzahlErrors in Validierungen In Datensätzen fehlen erforderliche Schemafelder wie poi_id, strukturierte location.address oder WGS84-Koordinaten. Sehen Sie sich den maximierten Bereich Validierungen an, um die betreffenden poi_ids zu ermitteln, korrigieren Sie die Pipelines für Ihren POI-Feed und importieren Sie den Feed noch einmal.
Zero Items processed Die Feeddatei ist leer oder beim Parsen des JSON-Arrays auf Stammebene sind Fehler aufgetreten. Prüfen Sie, ob die Struktur Ihres Feed-Wrappers der VssPoi-Nachrichtenspezifikation entspricht. Weitere Informationen finden Sie in den Richtlinien für die Verpackung von Feeds.