Traduttore 3.0: Ricerca dizionario

Articolo
09/22/2023

Fornisce traduzioni alternative per una parola e alcune frasi idiotiche. Ogni traduzione specifica la parte del discorso e include un elenco di traduzioni inverse. Le traduzioni inverse consentono all'utente di capire la traduzione nel contesto. L'operazione Esempio di dizionario permette di fare un'analisi più approfondita per vedere esempi di usi di ogni traduzione.

URL richiesta

Inviare una richiesta POST a:

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

VedereRete virtuale Supporto per il servizio Translator selezionato per la configurazione e la configurazione e il supporto dell'endpoint privato.

Parametri della richiesta

I parametri della richiesta inviati a una stringa di query sono:

Parametro della query	Descrizione
api-version	Parametro obbligatorio. Versione dell'API richiesta dal client. Il valore deve essere `3.0`
da	Parametro obbligatorio. Specifica la lingua del testo di input. La lingua di origine deve essere una delle lingue supportate incluse nell'ambito `dictionary`.
in	Parametro obbligatorio. Specifica la lingua del testo di output. La lingua di destinazione deve essere una delle lingue supportate incluse nell'ambito `dictionary`.

Le intestazioni della richiesta includono:

Intestazioni	Descrizione
Intestazioni di autenticazione	Intestazione della richiesta obbligatoria. Vedere Autenticazione.
Content-Type	Intestazione della richiesta obbligatoria. Specifica il tipo di contenuto del payload. I valori possibili sono:`application/json`.
Content-Length	Intestazione della richiesta obbligatoria. Lunghezza del corpo della richiesta.
X-ClientTraceId	Facoltativo. GUID generato dal client che identifica in modo univoco la richiesta. È possibile omettere questa intestazione se nella stringa della query si include l'ID traccia usando un parametro di query denominato `ClientTraceId`.

Testo della richiesta

Il corpo della richiesta è una matrice JSON. Ogni elemento matrice è un oggetto JSON con una proprietà stringa denominata Text, che rappresenta il termine da cercare.

[
    {"Text":"fly"}
]

Si applicano le limitazioni seguenti:

La matrice deve essere composta al massimo da 10 elementi.
Il valore di testo di un elemento di matrice non può superare i 100 caratteri, inclusi gli spazi.

Corpo della risposta

Una risposta corretta è una matrice JSON con un risultato per ogni stringa nella matrice di input. Un oggetto risultato include le proprietà seguenti:

normalizedSource: una stringa che offre la forma normalizzata del termine di origine. Ad esempio, se la richiesta è JOHN, il formato normalizzato è john. Il contenuto di questo campo diventa l'input per gli esempi di ricerca.
displaySource: una stringa che offre il termine di origine in un formato più adatto per la visualizzazione da parte dell'utente finale. Ad esempio, se l'input è JOHN, il modulo di visualizzazione riflette l'ortografia consueta del nome: John.
translations: un elenco di traduzioni per il termine di origine. Ogni elemento dell'elenco è un oggetto con le proprietà seguenti:
normalizedTarget: una stringa che fornisce la forma normalizzata del termine nella lingua di destinazione. Questo valore deve essere usato come input per gli esempi di ricerca.
displayTarget: una stringa che offre il termine nella lingua di destinazione e in un formato più adatto per la visualizzazione da parte dell'utente finale. In genere, questa proprietà differisce solo da normalizedTarget in termini di capitalizzazione. Ad esempio, un sostantivo appropriato come Juan ha normalizedTarget = "juan" e displayTarget = "Juan".
posTag: una stringa che associa il termine a un tag che identifica la parte del discorso.

Nome del tag Descrizione

ADJ Aggettivi

ADV Avverbi

CONJ Congiunzioni

DET Determinanti

MODAL Verbi

NOUN Sostantivi

PREP Preposizioni

PRON Pronomi

VERB Verbi

OTHER Altro

Come nota di implementazione, questi tag fanno parte del riconoscimento vocale sul lato inglese e quindi accettano il tag più frequente per ogni coppia di origine/destinazione. Pertanto, se gli utenti spesso traducono una parola spagnola nel tag di una parte del discorso diversa in inglese, si potrebbe rilevare che i tag contengono errori rispetto al termine spagnolo.
confidence: valore compreso tra 0,0 e 1,0 che rappresenta la "confidenza" (o più accuratamente, "probabilità nei dati di training") di tale coppia di traduzione. La somma dei punteggi di attendibilità per un termine di origine potrebbero sommarsi a 1,0 oppure no.
prefixWord: una stringa che specifica il termine da visualizzare come prefisso della traduzione. Attualmente, questa proprietà è il determinatore di genere dei sostantivi, in lingue con determinatiri di genere. Ad esempio, il prefisso della parola mosca spagnola è la, perché mosca è un sostantivo femminile in spagnolo. Questo valore dipende solo dalla traduzione e non dall'origine. Se non è presente alcun prefisso, si tratta della stringa vuota.
backTranslations: un elenco di "traduzioni inverse" del termine di destinazione. Ad esempio, i termini di origine con cui è possibile tradurre quelli di destinazione. L'elenco è garantito che contenga la parola di origine richiesta( ad esempio, se la parola di origine cercata è fly, è garantito che fly si trova nell'elenco backTranslations ). Tuttavia, non è garantito che sia nella prima posizione, e spesso non è. Ogni elemento dell'elenco backTranslations è un oggetto descritto dalle proprietà seguenti:
- normalizedText: una stringa che fornisce la forma normalizzata del termine di origine sotto forma di traduzione inversa del termine di destinazione. Questo valore deve essere usato come input per gli esempi di ricerca.
- displayText: una stringa che fornisce il termine di origine sotto forma di traduzione inversa del termine di destinazione più adatta per essere visualizzata dall'utente finale.
- numExamples: un numero intero che rappresenta la quantità di esempi disponibili per questa coppia di traduzione. Gli esempi effettivi devono essere recuperati con una chiamata separata agli esempi di ricerca. Il numero è principalmente destinato a facilitare la visualizzazione nell'esperienza utente. Ad esempio, un'interfaccia utente può aggiungere un collegamento ipertestuale alla traduzione back-translation se il numero di esempi è maggiore di zero. La traduzione back-translation viene quindi visualizzata come testo normale se non sono presenti esempi. Il numero effettivo di esempi restituiti da una chiamata agli esempi di ricerca può essere minore di numExamples, perché è possibile applicare più filtri sul riquadro a comparsa per rimuovere esempi "cattivi".
- frequencyCount: un numero intero che rappresenta la frequenza di questa coppia di traduzione nei dati. Lo scopo principale di questo campo è fornire un'interfaccia utente con un mezzo per ordinare le traduzioni inverse in modo che vengano visualizzati per primi i termini più frequenti.
  
  Nota
  
  Se il termine cercato non esiste nel dizionario, la risposta è 200 (OK) ma l'elenco translations è vuoto.

Nome del tag	Descrizione
ADJ	Aggettivi
ADV	Avverbi
CONJ	Congiunzioni
DET	Determinanti
MODAL	Verbi
NOUN	Sostantivi
PREP	Preposizioni
PRON	Pronomi
VERB	Verbi
OTHER	Altro

Esempio

In questo esempio viene illustrato come cercare traduzioni alternative in spagnolo del termine fly inglese .

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'}]"

Il corpo della risposta (abbreviato per maggiore chiarezza) è:

[
    {
        "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
            //
        ]
    }
]

Questo esempio mostra cosa accade quando il termine da cercare non esiste per la coppia di dizionari validi.

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'}]"

Poiché il termine non viene trovato nel dizionario, il corpo della risposta include un elenco vuoto translations .

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