Skip to main content

Onboarding Display Provider

No contexto do serviçserviço de Tracking, um Display Provider éé um provedor USS que tem objetivo de exibir a posiçãposição de drones em tempo real para seus usuáusuários.

PréPré-requisitos tétécnicos

Para um USS se tornar um provedor de display de Tracking existem os seguintes prépré-requisitos tétécnicos que nãnão estãestão no escopo dessa documentaçãdocumentação, ficando a critécritério do provedor como implementar esses prépré-requisitos:

  1. Possuir um servidor HTTP para solicitar e receber requisiçõrequisições
  2. Possuir App para visualizaçãvisualização de posiçãposição de drones

AutenticaçãAutenticação

Para o ensaio, a autenticaçãautenticação seráserá feita em um serviçserviço OAuth centralizado do DECEA, ainda a ser descrito.

Endpoints

A dinâdinâmica de comunicaçãcomunicação entre Service Provider, Display Provider e DSS estáestá descrita na norma ASTM 3411-22a. Para facilitar o entendimento, alguns possípossíveis cenácenários de utilizaçãutilização estãestão descritos na pápágina CenáCenários.

O padrãpadrão seguido no ensaio seráserá o descrito em https://github.com/uastech/standards/tree/astm_rid_api_2.1/remoteid

Conforme o padrãpadrão OpenAPI acima, os endpoints que o Display Provider precisaráprecisará prover:

POST /uss/identification_service_areas/{id}
Path Parameters
id UUID da ISA
Request Body

  

InteraçãInteração com DSS

O Service Provider, conforme definido no padrãpadrão ASTM3411-22a, deve criar entidades de Subscription em uma áárea especíespecífica, para encontrar os atuais Service Providers, e tambétambém para receberem notificaçõnotificações caso novos provedores se registrem na áárea. Os endpoints expostos pelo DSS estãestão descritos no arquivo OpenAPI descrito acima.

Como exemplo, o endpoint abaixo éé para criaçãcriação de Subscriptions:

PUT /dss/subscriptions/{id}
Path Parameters
id UUID da Subscription, criado pelo Display Provider
Request Body 
{
  "extents": {
    "volume": {
      "outline_circle": {
        "center": {
          "lng": -118.456,
          "lat": 34.123
        },
        "radius": {
          "value": 300.183,
          "units": "M"
        }
      },
      "outline_polygon": {
        "vertices": [
          {
            "lng": -118.456,
            "lat": 34.123
          },
          {
            "lng": -118.456,
            "lat": 34.123
          },
          {
            "lng": -118.456,
            "lat": 34.123
          }
        ]
      },
      "altitude_lower": {
        "value": 19.5,
        "reference": "W84",
        "units": "M"
      },
      "altitude_upper": {
        "value": 19.5,
        "reference": "W84",
        "units": "M"
      }
    },
    "time_start": {
      "value": "1985-04-12T23:20:50.52Z",
      "format": "RFC3339"
    },
    "time_end": {
      "value": "1985-04-12T23:20:50.52Z",
      "format": "RFC3339"
    }
  },
  "uss_base_url": "https://example.com/rid"
}

Campos notánotáveis

volume PolíPolígono OU cícírculo da áárea, idêidêntico ao definido no SARPAS
altitude_lower, altitude_upper

Altitude geodégeodésica (WSG84, W84) mámáxima e mímínima em metros.  
time_start, time_end

HoráHorário de iníinício e fim da áárea. Todos os horáhorários devem estar no timezone Zulo (UTC+0). O úúnico formato suportado éé "RFC3339"
uss_base_url

URL a qual o Service Provider iráirá responder àà solicitaçõsolicitações. NãNão deve conter uma barra '/' ao final. Sugere-se utilizar uma URL e nãnão um IP.
Response Body 
{
  "service_areas": [],
  "subscription": {
    "id": "string",
    "uss_base_url": "https://example.com/rid",
    "owner": "myuss",
    "notification_index": 0,
    "time_end": {
      "value": "1985-04-12T23:20:50.52Z",
      "format": "RFC3339"
    },
    "time_start": {
      "value": "1985-04-12T23:20:50.52Z",
      "format": "RFC3339"
    },
    "version": "string"
  }
}
service_areas Lista de ISAs jájá existentes no volume 4D. Caso a lista nãnão esteja vazia, o Display Provider deve solicitar os dados de telemetria para as URLs definidas na lista
version VersãVersão da Subscription, gerado pelo DSS, para garantia de integridade. ÉÉ necessánecessário utilizar esse campo para atualizar ou deletar uma Subscription.
Back to top