Entity

Stellt einen Ausdruck im Text dar, der eine bekannte Entität ist, z. B. eine Person, eine Organisation oder ein Standort. Die API verknüpft Informationen wie Auffälligkeiten und Erwähnungen mit Entitäten.

JSON-Darstellung 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "salience": number,
  "mentions": [
    {
      object (EntityMention)
    }
  ],
  "sentiment": {
    object (Sentiment)
  }
}
Felder
name

string

Der repräsentative Name für die Entität.
type

enum (Type)

Der Entitätstyp.
metadata

map (key: string, value: string)

Die mit der Entität verknüpften Metadaten.

Bei den meisten Entitätstypen sind die Metadaten eine Wikipedia-URL (wikipedia_url) und eine Knowledge Graph MID (mid), sofern verfügbar. Die Metadaten für andere Entitätstypen finden Sie in der Tabelle „Typ“ unten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
salience

number

Der Auffälligkeitswert, der mit der Entität im Bereich [0, 1,0] verknüpft ist.

Der Auffälligkeitswert zeigt den Stellenwert oder die Zentralität einer Entität im gesamten Dokumenttext an. Werte, die näher bei 0 liegen, haben eine niedrige Auffälligkeit. Werte, die näher bei 1,0 liegen, haben eine hohe Auffälligkeit.
mentions[]

object (EntityMention)

Die Erwähnungen dieser Entität im Eingabedokument. Die API unterstützt derzeit Erwähnungen von Eigennamen.
sentiment

object (Sentiment)

Bei Aufrufen von AnalyzeEntitySentimentRequest oder wenn AnnotateTextRequest.Features.extract_entity_sentiment auf „wahr“ gesetzt ist, enthält dieses Feld das aggregierte Sentiment, das im bereitgestellten Dokument für dieses Rechtssubjekt ausgedrückt wird.

Typ

Der Typ der Entität. Für die meisten Entitätstypen sind die zugehörigen Metadaten eine Wikipedia-URL (wikipedia_url) und eine Knowledge Graph MID (mid). In der folgenden Tabelle sind die zugehörigen Felder für Entitäten mit anderen Metadaten aufgeführt.

Enums
UNKNOWN Unbekannt
PERSON Person
LOCATION Ort
ORGANIZATION Organisation
EVENT Ereignis
WORK_OF_ART Kunstwerk
CONSUMER_GOOD Verbraucherprodukt
OTHER Andere Entitätstypen
PHONE_NUMBER

Telefonnummer

Die Metadaten enthalten die Telefonnummer, die gemäß den örtlichen Konventionen formatiert ist, sowie alle zusätzlichen Elemente, die im Text erscheinen:

  • number: die tatsächliche Nummer, unterteilt in Abschnitte gemäß lokaler Konvention
  • national_prefix – Ländercode, falls erkannt
  • area_code – Region oder Vorwahl, falls erkannt
  • extension – Telefonweiterleitung (wird nach der Verbindung gewählt), falls erkannt
ADDRESS

Adresse

Die Metadaten enthalten die Hausnummer und den Ort sowie alle zusätzlichen Elemente, die im Text erscheinen:

  • street_number – Hausnummer
  • locality – Stadt
  • street_name – Name der Straße/Route, falls erkannt
  • postal_code – Postleitzahl, falls erkannt
  • country – Land, falls erkannt<
  • broad_region – Verwaltungsgebiet, z. B. der Bundesstaat, falls erkannt
  • narrow_region – kleineres Verwaltungsgebiet, z. B. ein Landkreis, falls erkannt
  • sublocality – wird in asiatischen Adressen verwendet, um einen Bezirk innerhalb einer Stadt anzugeben, sofern erkannt
DATE

Datum

In den Metadaten werden die Komponenten des Datums angegeben:

  • year – vierstellige Jahreszahl, falls erkannt
  • month – zweistellige Monatszahl, falls erkannt
  • day – zweistellige Tageszahl, falls erkannt
NUMBER

Zahl

Die Metadaten sind die Zahl selbst.
PRICE

Preis

Die Metadaten identifizieren die value und currency.

EntityMention

Stellt eine Erwähnung einer Entität im Text dar. Derzeit werden Erwähnungen von Eigennamen unterstützt.

JSON-Darstellung 
{
  "text": {
    object (TextSpan)
  },
  "type": enum (Type),
  "sentiment": {
    object (Sentiment)
  }
}
Felder
text

object (TextSpan)

Der Erwähnungstext.
type

enum (Type)

Der Typ der Entitätserwähnung.
sentiment

object (Sentiment)

Bei Aufrufen von AnalyzeEntitySentimentRequest oder wenn AnnotateTextRequest.Features.extract_entity_sentiment auf „wahr“ festgelegt ist, enthält dieses Feld das Sentiment, das für diese Erwähnung des Rechtssubjekts im bereitgestellten Dokument ausgedrückt wird.

Typ

Die unterstützten Erwähnungstypen.

Enums
TYPE_UNKNOWN Unbekannt
PROPER Eigenname
COMMON Gattungsname (oder Kompositum)