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 Wahrscheinlichkeit und Erwähnungen mit Entitäten.

JSON-Darstellung 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "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.

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" }.
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. In der folgenden Tabelle sind die zugehörigen Felder für Entitäten mit unterschiedlichen 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)
  },
  "probability": number
}
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“ gesetzt ist, enthält dieses Feld das Sentiment, das für diese Erwähnung des Rechtssubjekts im bereitgestellten Dokument ausgedrückt wird.
probability

number

Wahrscheinlichkeitsbewertung, die mit der Entität verknüpft ist.

Der Wert gibt die Wahrscheinlichkeit an, dass die Entitätserwähnung dem Entitätstyp entspricht. Der Wert liegt im Bereich [0, 1].

Typ

Die unterstützten Erwähnungstypen.

Enums
TYPE_UNKNOWN Unbekannt
PROPER Eigenname
COMMON Gattungsname (oder Kompositum)