L'avvio di processi di analisi del layout tramite l'API può essere fatto con richieste POST a
https://transkribus.eu/TrpServer/rest/LA
I seguenti parametri di query sono disponibili su questo endpoint:
collId
l'ID di raccolta con i documenti che si desidera elaboraredoBlockSeg
true
-> il layout esistente verrà cancellatofalse
(predefinito) -> mantiene le regioni dei blocchi di testo esistenti
doLineSeg
true
(predefinito) -> rileva le linee nei blocchi di testofalse
-> Mantenere le linee esistenti
doPolygonToBaseline
true
-> ispezionare poligoni di linee e aggiungere linee di basefalse
(predefinito) -> mantiene le linee di base esistenti
doBaselineToPolygon
true
-> estrapolare nuovi poligoni di linee dalle linee di basefalse
(predefinito) -> salta
jobImpl
: lo strumento da utilizzare, quello predefinito (omettendo questo parametro) è "TranskribusLAJob", consigliato per la maggior parte dei documenti.
Il request body specifica le pagine da elaborare, in termini di ID del documento e ID della pagina. Opzionalmente, un ID di trascrizione (tsId) può specificare una versione di trascrizione e gli ID degli elementi della regione XML PAGE possono essere passati per elaborare sezioni specifiche di una pagina. L'endpoint accetta JSON o XML:
{ "docList" : { "docs" : [ { "docId" : 1543, "pageList" : { "pages" : [ { "pageId" : 1234, "regionIds" : [ "the_xml_id_of_a_text_region" ] }, { "pageId" : 12345, "tsId" : 1234567 } ] } } ] } }
Rappresentazione XML equivalente:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <jobParameters> <docList> <docs> <docId>1543</docId> <pageList> <pages> <pageId>1234</pageId> <regionIds>the_xml_id_of_a_text_region</regionIds> </pages> <pages> <pageId>12345</pageId> <tsId>1234567</tsId> </pages> </pageList> </docs> </docList> </jobParameters>
Se ha successo (codice di stato HTTP 200), la risposta conterrà un oggetto di stato del lavoro con un jobId che può essere usato per monitorare il progresso (vedere Lavoro API).