Translator 3.0: Ordlistesökning

  • Artikel

Tillhandahåller alternativa översättningar för ett ord och några idiomatiska fraser. Varje översättning har en del av talet och en lista över back-translations. Med bakgrundsöversättningar kan en användare förstå översättningen i sitt sammanhang. Åtgärden Ordlisteexempel gör att du kan öka detaljnivån ytterligare för att se exempel på användning av varje översättningspar.

Begärans-URL

Skicka en POST-begäran till:

https://api.cognitive.microsofttranslator.com/dictionary/lookup?api-version=3.0

SeVirtual Network Support för Translator-tjänstens valda konfiguration och support för nätverk och privat slutpunkt.

Parametrar för begäran

Begäransparametrar som skickas på frågesträngen är:

Frågeparameter Description
api-version Obligatorisk parameter.
Version av API:et som begärs av klienten. Värdet måste vara 3.0
Från Obligatorisk parameter.
Anger språket för indatatexten. Källspråket måste vara ett av de språk som stöds i omfånget dictionary .
på Obligatorisk parameter.
Anger språket för utdatatexten. Målspråket måste vara ett av de språk som stöds i omfånget dictionary .

Begärandehuvuden är:

Sidhuvuden Description
Autentiseringshuvuden Obligatoriskt begärandehuvud.
Se Autentisering.
Content-Type Obligatoriskt begärandehuvud.
Anger nyttolastens innehållstyp. Möjliga värden är: application/json.
Innehållslängd Obligatoriskt begärandehuvud.
Längden på begärandetexten.
X-ClientTraceId Valfritt.
Ett klientgenererat GUID för att unikt identifiera begäran. Du kan utelämna det här huvudet om du inkluderar spårnings-ID:t i frågesträngen med hjälp av en frågeparameter med namnet ClientTraceId.

Begärandetext

Brödtexten i begäran är en JSON-matris. Varje matriselement är ett JSON-objekt med en strängegenskap med namnet Text, som representerar termen som ska slås upp.

[
    {"Text":"fly"}
]

Följande begränsningar gäller:

  • Matrisen kan innehålla högst 10 element.
  • Textvärdet för ett matriselement får inte överstiga 100 tecken, inklusive blanksteg.

Själva svaret

Ett lyckat svar är en JSON-matris med ett resultat för varje sträng i indatamatrisen. Ett resultatobjekt innehåller följande egenskaper:

  • normalizedSource: En sträng som ger den normaliserade formen av källtermen. Om begäran till exempel är JOHNär johndet normaliserade formuläret . Innehållet i det här fältet blir indata för uppslagsexempel.

  • displaySource: En sträng som ger källtermen i ett formulär som passar bäst för slutanvändarvisning. Om indata till exempel är JOHNåterspeglar visningsformuläret den vanliga stavningen av namnet: John.

  • translations: En lista över översättningar för källtermen. Varje element i listan är ett objekt med följande egenskaper:

  • normalizedTarget: En sträng som ger den normaliserade formen av den här termen på målspråket. Det här värdet ska användas som indata för uppslagsexempel.

  • displayTarget: En sträng som ger termen på målspråket och i ett formulär som passar bäst för slutanvändarvisning. I allmänhet skiljer sig den här egenskapen bara från normalizedTarget versaler. Ett lämpligt substantiv som Juan har normalizedTarget = "juan" till exempel och displayTarget = "Juan".

  • posTag: En sträng som associerar den här termen med en del av taltaggen.

    Taggnamn Description
    ADJ Adjektiv
    ADV Adverb
    CONJ Konjunktioner
    DET Determinrar
    MODALA Verb
    SUBSTANTIV Substantiv
    PREP Prepositioner
    PRON Pronomen
    VERB Verb
    ANDRA Övrigt

    Som en implementeringsanteckning är dessa taggar en del av talet som taggar den engelska sidan och sedan tar den vanligaste taggen för varje käll-/målpar. Så om människor ofta översätter ett spanskt ord till en annan del av taltaggen på engelska, kan taggar hamna fel (med avseende på det spanska ordet).

  • confidence: Ett värde mellan 0,0 och 1,0 som representerar "konfidensen" (eller mer exakt "sannolikheten i träningsdata") för det översättningsparet. Summan av konfidenspoängen för ett källord kan summeras till 1,0.

  • prefixWord: En sträng som ger ordet som ska visas som ett prefix för översättningen. För närvarande är den här egenskapen den könsbestämda bestämmeren av substantiv, på språk som har könsbestämda determinerare. Prefixet för det spanska ordet mosca är latill exempel , eftersom mosca är ett feminint substantiv på spanska. Det här värdet är bara beroende av översättningen och inte på källan. Om det inte finns något prefix är det den tomma strängen.

  • backTranslations: En lista över "bakåtöversättningar" av målet. Till exempel källord som målet kan översättas till. Listan innehåller garanterat det begärda källordet (om källordet som slås upp till exempel är fly, är det garanterat att fly det finns i backTranslations listan). Det är dock inte garanterat att vara i den första positionen, och det är det ofta inte. Varje element i backTranslations listan är ett objekt som beskrivs av följande egenskaper:

    • normalizedText: En sträng som ger den normaliserade formen av källtermen som är en bakåtöversättning av målet. Det här värdet ska användas som indata för uppslagsexempel.

    • displayText: En sträng som ger källtermen som är en bakåtöversättning av målet i ett formulär som passar bäst för slutanvändarvisning.

    • numExamples: Ett heltal som representerar antalet exempel som är tillgängliga för det här översättningsparet. Faktiska exempel måste hämtas med ett separat anrop till uppslagsexempel. Talet är främst avsett att underlätta visning i ett UX. Ett användargränssnitt kan till exempel lägga till en hyperlänk till serveröversättningen om antalet exempel är större än noll. Sedan visas back-translationen som oformaterad text om det inte finns några exempel. Det faktiska antalet exempel som returneras av ett anrop till uppslagsexempel kan vara mindre än numExamples, eftersom mer filtrering kan tillämpas i farten för att ta bort "dåliga" exempel.

    • frequencyCount: Ett heltal som representerar frekvensen för det här översättningsparet i data. Huvudsyftet med det här fältet är att tillhandahålla ett användargränssnitt med ett sätt att sortera back-translations så att de vanligaste termerna är först.

      Anteckning

      Om termen som slås upp inte finns i ordlistan är svaret 200 (OK) men listan translations är en tom lista.

Exempel

Det här exemplet visar hur du söker efter alternativa översättningar på spanska av den engelska termen fly .

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/lookup?api-version=3.0&from=en&to=es" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly'}]"

Svarstexten (förkortad för tydlighetens skull) är:

[
    {
        "normalizedSource":"fly",
        "displaySource":"fly",
        "translations":[
            {
                "normalizedTarget":"volar",
                "displayTarget":"volar",
                "posTag":"VERB",
                "confidence":0.4081,
                "prefixWord":"",
                "backTranslations":[
                    {"normalizedText":"fly","displayText":"fly","numExamples":15,"frequencyCount":4637},
                    {"normalizedText":"flying","displayText":"flying","numExamples":15,"frequencyCount":1365},
                    {"normalizedText":"blow","displayText":"blow","numExamples":15,"frequencyCount":503},
                    {"normalizedText":"flight","displayText":"flight","numExamples":15,"frequencyCount":135}
                ]
            },
            {
                "normalizedTarget":"mosca",
                "displayTarget":"mosca",
                "posTag":"NOUN",
                "confidence":0.2668,
                "prefixWord":"",
                "backTranslations":[
                    {"normalizedText":"fly","displayText":"fly","numExamples":15,"frequencyCount":1697},
                    {"normalizedText":"flyweight","displayText":"flyweight","numExamples":0,"frequencyCount":48},
                    {"normalizedText":"flies","displayText":"flies","numExamples":9,"frequencyCount":34}
                ]
            },
            //
            // ...list abbreviated for documentation clarity
            //
        ]
    }
]

Det här exemplet visar vad som händer när termen som slås upp inte finns för det giltiga ordlisteparet.

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/lookup?api-version=3.0&from=en&to=es" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly123456'}]"

Eftersom termen inte finns i ordlistan innehåller svarstexten en tom translations lista.

[
    {
        "normalizedSource":"fly123456",
        "displaySource":"fly123456",
        "translations":[]
    }
]