Consulta de la lista de muestra de una tarea de etiquetado de equipo por página
Función
Esta API se utiliza para consultar la lista de muestra de un equipo de etiquetado tarea por página.
URI
GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
dataset_id |
Sí |
String |
ID de conjunto de datos. |
project_id |
Sí |
String |
ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto. |
workforce_task_id |
Sí |
String |
ID de una tarea de etiquetado de equipo. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
label_name |
No |
String |
Nombre de la etiqueta. |
label_type |
No |
Integer |
Tipo de etiquetado. Opciones:
|
limit |
No |
Integer |
Número máximo de registros devueltos en cada página. El valor varía de 1 a 100. El valor predeterminado es 10. |
locale |
No |
String |
Idioma. Opciones:
|
offset |
No |
Integer |
Página de inicio de la lista de paginación. El valor predeterminado es 0. |
process_parameter |
No |
String |
Ajuste de cambio de tamaño de imagen, que es el mismo que el ajuste de cambio de tamaño de OBS. Para obtener más información, consulte Cambio del tamaño de las imágenes.For example, image/resize,m_lfit,h_200 indicates that the target image is resized proportionally and the height is set to 200 pixels. |
sample_state |
No |
String |
Estado de la muestra. Opciones:
|
search_conditions |
No |
String |
Condición de búsqueda multidimensional después de la codificación de URL. La relación entre múltiples condiciones de búsqueda es AND. |
Parámetros de solicitud
Ninguno
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
sample_count |
Integer |
Número de muestras. |
samples |
Array of DescribeSampleResp objects |
Lista de muestra. |
Parámetro |
Tipo |
Descripción |
---|---|---|
check_accept |
Boolean |
Si se aprueba la aceptación, que se utiliza para el etiquetado del equipo. Opciones:
|
check_comment |
String |
Comentario de aceptación, que se utiliza para el etiquetado del equipo. |
check_score |
String |
Puntuación de aceptación, que se utiliza para el etiquetado de equipos. |
deletion_reasons |
Array of strings |
Motivo para eliminar una muestra, que se utiliza para la atención médica. |
hard_details |
Map<String,HardDetail> |
Detalles sobre las dificultades, incluyendo descripción, causas y sugerencias de problemas difíciles. |
labelers |
Array of Worker objects |
Lista de personal de etiquetado de asignación de muestra. Las etiquetadoras registran los miembros del equipo a los que se asigna la muestra para el etiquetado del equipo. |
labels |
Array of SampleLabel objects |
Lista de etiquetas de muestra. |
metadata |
SampleMetadata object |
Par clave-valor del atributo de muestra metadata. |
review_accept |
Boolean |
Si se acepta la revisión, que se utiliza para el etiquetado del equipo. Opciones:
|
review_comment |
String |
Comentario de revisión, que se utiliza para el etiquetado de equipos. |
review_score |
String |
Puntuación de revisión, que se utiliza para el etiquetado de equipos. |
sample_data |
Array of strings |
Lista de datos de muestra. |
sample_dir |
String |
Ruta de muestra. |
sample_id |
String |
ID de muestra. |
sample_name |
String |
Nombre de muestra. |
sample_size |
Long |
Tamaño de muestra o longitud del texto, en bytes. |
sample_status |
String |
Estado de la muestra. Opciones:
|
sample_time |
Long |
Tiempo de muestra, cuando OBS se modifica por última vez. |
sample_type |
Integer |
Tipo de muestra. Opciones:
|
score |
String |
Puntuación integral, que se utiliza para el etiquetado de equipos. |
source |
String |
Dirección de origen de los datos de muestra. |
sub_sample_url |
String |
URL de la submuestra, que se utiliza para el cuidado de la salud. |
worker_id |
String |
ID de un miembro del equipo de etiquetado, que se utiliza para el etiquetado del equipo. |
Parámetro |
Tipo |
Descripción |
---|---|---|
alo_name |
String |
Alias. |
id |
Integer |
ID de razón. |
reason |
String |
Descripción de razón. |
suggestion |
String |
Sugerencia de manejo. |
Parámetro |
Tipo |
Descripción |
---|---|---|
create_time |
Long |
Tiempo de creación. |
description |
String |
Descripción del miembro del equipo de etiquetado. El valor contiene de 0 a 256 caracteres y no admite los siguientes caracteres especiales: ^!<>=&"' |
|
String |
Dirección de correo electrónico de un miembro del equipo de etiquetado. |
role |
Integer |
Rol. Opciones:
|
status |
Integer |
Estado actual de inicio de sesión de un miembro del equipo de etiquetado. Opciones:
|
update_time |
Long |
Tiempo de actualización. |
worker_id |
String |
ID de un miembro del equipo de etiquetado. |
workforce_id |
String |
ID de un equipo de etiquetado. |
Parámetro |
Tipo |
Descripción |
---|---|---|
annotated_by |
String |
Método de etiquetado de vídeo, que se utiliza para distinguir si un vídeo se etiqueta manualmente o automáticamente. Opciones:
|
id |
String |
ID de la etiqueta. |
name |
String |
Nombre de la etiqueta. |
property |
SampleLabelProperty object |
Par de atributo clave-valor de la etiqueta de ejemplo, como la forma del objeto y características de forma. |
score |
Float |
Confianza. |
type |
Integer |
Tipo de etiqueta. Opciones:
|
Parámetro |
Tipo |
Descripción |
---|---|---|
@modelarts:content |
String |
Contenido de texto de voz, que es un atributo predeterminado dedicado a la etiqueta de voz . (incluido el contenido del habla y los puntos de inicio y final del habla). |
@modelarts:end_index |
Integer |
Posición final del texto, que es un atributo predeterminado dedicado a la etiqueta de entidad con nombre. La posición final no incluye el carácter correspondiente al valor de end_index. Los ejemplos son los siguientes.- Si el contenido del texto es "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", los valores start_index y end_index de "Barack Hussein Obama II" son 0 y 23, respectivamente.- Si el contenido del texto es "By the end of 2018, the company has more than 100 employees.", los valores start_index y end_index de "By the end of 2018" son 0 y 18, respectivamente. |
@modelarts:end_time |
String |
Tiempo de finalización de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz, en el formato de hh:mm:ss.SSS. (hh indica la hora; mm indica el minuto; ss indica el segundo; y SSS indica el milisegundo.) |
@modelarts:feature |
Object |
Característica de forma, que es un atributo predeterminado dedicado a la etiqueta de detección de objetos, con tipo de List. La esquina superior izquierda de una imagen se utiliza como el origen de coordenadas [0,0]. Cada punto de coordenada está representado por [x, y]. x indica la coordenada horizontal e y indica la coordenada vertical . (tanto x como y son mayores o iguales a 0). El formato de cada forma es el siguiente: - bndbox: consta de dos puntos, por ejemplo, [[0,10],[50,95]]. El primer punto se encuentra en la esquina superior izquierda del rectángulo y el segundo punto se encuentra en la esquina inferior derecha del rectángulo. Es decir, la coordenada X del primer punto debe ser menor que la del segundo punto, y la coordenada Y del segundo punto debe ser menor que la del primer punto.- polygon: consiste en múltiples puntos que están conectados en secuencia para formar un polígono, por ejemplo, [[0,100],[50,95],[10,60],[500,400]].- circle: consiste en el punto central y el radio, por ejemplo, [[100,100],[50]].- line: consta de dos puntos, por ejemplo, [[0,100],[50,95]]. El primer punto es el punto de inicio, y el segundo punto es el punto final.- dashed: consta de dos puntos, por ejemplo, [[0,100],[50,95]]. El primer punto es el punto inicial, y el segundo punto es el punto final.- point: consiste en un punto, por ejemplo, [[0,100]].- polyline: consiste en múltiples puntos, por ejemplo, [[0,100],[50,95],[10,60],[500,400]]. |
@modelarts:from |
String |
ID de la entidad de cabeza en la etiqueta de relación de triplete, que es un atributo por defecto dedicado a la etiqueta de relación de triplete. |
@modelarts:hard |
String |
Muestra etiquetada como muestra dura o no, que es un atributo predeterminado. Opciones:
|
@modelarts:hard_coefficient |
String |
Coeficiente de dificultad de cada nivel de etiqueta, que es un atributo predeterminado. El rango de valores es [0,1]. |
@modelarts:hard_reasons |
String |
Razones por las que la muestra es una muestra dura, que es un atributo predeterminado. Utilice un guion (-) para separar cada dos ID de motivos de muestra dura, por ejemplo, 3-20-21-19. Opciones:
|
@modelarts:shape |
String |
Forma de objeto, que es un atributo predeterminado dedicado a la etiqueta de detección de objetos y se deja vacía de forma predeterminada. Opciones:
|
@modelarts:source |
String |
Fuente de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz y que puede ajustarse a un altavoz o narrador. |
@modelarts:start_index |
Integer |
Posición inicial del texto, que es un atributo predeterminado dedicado a la etiqueta de entidad con nombre. El valor inicial comienza desde 0, incluyendo el carácter correspondiente al valor de start_index. |
@modelarts:start_time |
String |
Tiempo de inicio de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz, en el formato de hh:mm:ss.SSS. (hh indica la hora; mm indica el minuto; ss indica el segundo; y SSS indica el milisegundo.) |
@modelarts:to |
String |
ID de la entidad de cola en la etiqueta de relación de triplete, que es un atributo por defecto dedicado a la etiqueta de relación de triplete. |
Parámetro |
Tipo |
Descripción |
---|---|---|
@modelarts:import_origin |
Integer |
Fuente de ejemplo, que es un atributo integrado. |
@modelarts:hard |
Double |
Si la muestra está etiquetada como muestra dura, que es un atributo predeterminado. Opciones:
|
@modelarts:hard_coefficient |
Double |
Coeficiente de dificultad de cada nivel de muestra, que es un atributo predeterminado. El rango de valores es [0,1]. |
@modelarts:hard_reasons |
Array of integers |
ID de una razón de ejemplo difícil, que es un atributo predeterminado. Opciones:
|
@modelarts:size |
Array of objects |
Tamaño de la imagen (ancho, alto y profundidad de la imagen), que es un atributo predeterminado, con tipo de List. En la lista, el primer número indica la anchura (píxeles), el segundo número indica la altura (píxeles) y el tercer número indica la profundidad . (la profundidad puede dejarse en blanco y el valor predeterminado es 3). Por ejemplo, [100,200,3] y [100,200] son válidos. Nota: Este parámetro sólo es obligatorio cuando la lista de etiquetas de ejemplo contiene la etiqueta de detección de objetos. |
Solicitudes de ejemplo
Consulta de la lista de muestra de una tarea de etiquetado de equipo por página
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples
Ejemplo de respuestas
Código de estado: 200
OK
{ "sample_count" : 2, "samples" : [ { "sample_id" : "26c6dd793d80d3274eb89349ec76d678", "sample_type" : 0, "labels" : [ ], "source" : "https://test-obs.obs.xxx.com:443/detect/data/dataset-car-and-person/IMG_kitti_0000_000016.png?AccessKeyId=P19W9X830R1Z39P5X5M5&Expires=1606300137&x-obs-security-token=gQpjbi1ub3J0aC03jKj8N6gtS4VsdTTW3QFoHMtpMoFLtCa6W_J4DxT0nYIfx...", "metadata" : { "@modelarts:import_origin" : 0, "@modelarts:size" : [ 1242, 375, 3 ] }, "sample_time" : 1598263639997, "sample_status" : "UN_ANNOTATION", "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", "labelers" : [ { "email" : "xxx@xxx.com", "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", "role" : 0 } ] }, { "sample_id" : "2971815bbb11a462161b48dddf19344f", "sample_type" : 0, "labels" : [ ], "source" : "https://test-obs.obs.xxx.com:443/detect/data/dataset-car-and-person/IMG_kitti_0000_000011.png?AccessKeyId=P19W9X830R1Z39P5X5M5&Expires=1606300137&x-obs-security-token=gQpjbi1ub3J0aC03jKj8N6gtS4VsdTTW3QFoHMtpMoFLtC...", "metadata" : { "@modelarts:import_origin" : 0, "@modelarts:size" : [ 1242, 375, 3 ] }, "sample_time" : 1598263639997, "sample_status" : "UN_ANNOTATION", "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", "labelers" : [ { "email" : "xxx@xxx.com", "worker_id" : "305595e1901a526017d2e11f3ab0ffe1", "role" : 0 } ] } ] }
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Códigos de error
Consulte Códigos de error.