Skip to content

Aimsun Next API Rastreio de Veículos

Modificar a Velocidade de um Veículo Rastreado

Em C++ e Python

Explicação

Modifique a velocidade de um veículo rastreado para o próximo passo de simulação, se for menor do que a velocidade calculada usando o modelo de seguimento de veículos.

Formato
int AKIVehTrackedModifySpeed (int aidVeh, double newSpeed);
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • newSpeed: Nova velocidade (Km/h ou Mph dependendo das unidades definidas na rede).
Saída
  • = 0: Sem erro
  • < 0: Erro

Forçar a Velocidade de um Veículo Rastreado

Em C++ e Python

Explicação

Force a velocidade de um veículo rastreado para o próximo passo de simulação sem considerar as restrições do modelo de seguimento de veículos.

Formato
int AKIVehTrackedForceSpeed (int aidVeh, double newSpeed);
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • newSpeed: Nova velocidade (Km/h ou Mph dependendo das unidades definidas na rede).
Saída
  • = 0: Sem erro
  • < 0: Erro

Modificar a Faixa de um Veículo Rastreado

Em C++ e Python

Explicação

Modifique a faixa alvo de um veículo rastreado até que ele tenha realizado a troca de faixa.

Existem condições que devem ser atendidas ao usar faixas laterais para entrar em uma seção. Se o veículo rastreado estiver em uma faixa lateral, e a nova faixa alvo for a faixa adjacente da seção da via, então a instrução da função AKIVehTrackedModifyLane está sujeita à presença de uma faixa virtual faixa contínua definida pela distância de junção e pela opção FIFO para a junção em rampa. Veja a seção sobre Junções em Rampa para mais detalhes.

Observe que no caso em que a instrução da função API é anulada pelos parâmetros de junção, a função API teria retornado 0 (Sem erro), pois teria definido a faixa alvo com sucesso, antes da aplicação das regras de junção.

O modelador pode garantir que a chamada da API nunca seja substituída definindo a distância da junção como sendo igual ao comprimento da faixa de junção e desmarcando a opção FIFO. Isso, no entanto, modificará o comportamento de todos os veículos na simulação e, portanto, deve ser usado com cuidado.

Formato
int AKIVehTrackedModifyLane (int aidVeh, int nextLane);
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • newLane: -1 próxima faixa à direita ou 1 próxima faixa à esquerda. 0 não mudar de faixa. -2 reiniciar, devolve o controle da faixa alvo ao modelo de simulação padrão.
Saída
  • = 0: Sem erro
  • < 0: Erro

Modificar a Próxima Seção de um Veículo Rastreado

Em C++ e Python

Explicação

Modifique a próxima seção de um veículo rastreado a fim de forçar uma curva, para o próximo passo de simulação.

Formato
int AKIVehTrackedModifyNextSection (int aidVeh, int nextSection);
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • nextSection: Próxima seção.
Saída
  • = 0: Sem erro
  • < 0: Erro

Modificar as Próximas Seções de um Veículo Rastreado

Em C++ apenas

Explicação

Modifique as próximas seções de um veículo rastreado a fim de forçar um subcaminho, para o próximo passo de simulação. A primeira seção dada deve ser uma seção imediatamente a jusante da seção atual do veículo. A lista de seções não atinge o centróide de destino do veículo. Uma vez que ele saia da última seção do subcaminho dado, o veículo calculará uma rota de sua localização até seu destino.

Formato
int AKIVehTrackedModifyNextSections (int aidVeh, int sizeNextSections, const int *nextSections);
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • sizeNextSections: Número de seções no subcaminho
  • nextSections: Array com os IDs das próximas seções. O número de seções deve ser igual a sizeNextSections
Saída
  • = 0: Sem erro
  • < 0: Erro

Exemplo de uso em C:

int * pathArray = (int *) calloc( pathSize, sizeof(int) );
for( int i = 0; i < pathSize; i++ ){
    pathArray[i] = sectionID[i];
}
int err = AKIVehTrackedModifyNextSections( vehId, pathSize, pathArray );
free( pathArray );

Modificar a Faixa de Entrada na Próxima Seção de um Veículo Rastreado

Em C++ e Python

Explicação

Define a faixa desejada que o veículo rastreado deve escolher ao entrar na próxima seção. A faixa desejada deve estar conectada à faixa atual. Caso contrário, o veículo não considerará a faixa desejada como sua faixa alvo.

Formato
int AKIVehTrackedModifyNextTargetLaneInNextSection(int aidVeh, int nextSection, int nextlane);
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • nextSection: Identificador da próxima seção.
  • nextlane: Posição da faixa desejada onde 1 é a faixa mais à direita e N a faixa mais à esquerda, onde N é o número de faixas na próxima seção.
Saída
  • = 0: Sem erro

Remover um Veículo Rastreado

Em C++ e Python

Explicação

Remova um veículo rastreado.

Formato
int AKIVehTrackedRemove (int aidVeh);
int AKIVehTrackedDelete (int aidVeh);  //Função antiga, mantida para compatibilidade
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída
  • = 0: Sem erro
  • < 0: Erro

Definir um Veículo como Rastreado / Não Rastreado

Em C++ e Python

Explicação

Defina um veículo como rastreado/ Defina um veículo como não rastreado

Formato
int AKIVehSetAsTracked (int aidVeh);
int AKIVehSetAsNoTracked (int aidVeh);
Parâmetros
  • aidVeh: Identificador do veículo.
Saída
  • = 0: Sem erro
  • < 0: Erro

Ler as informações de um Veículo Rastreado

Em C++ e Python

Explicação

Ler as informações de um veículo rastreado

Formato
InfVeh AKIVehTrackedGetInf(int aidVeh)
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída
struct InfVeh{
    int report;
    int idVeh;
    int type;
    // Informações no Veículo quando está em uma seção
    int idSection;
    int segment;
    int numberLane;

    // Informações no Veículo quando está em um nó
    int idJunction;
    int idSectionFrom;
    int idLaneFrom;
    int idSectionTo;
    int idLaneTo;

    double CurrentPos; 
    double distance2End;
    double xCurrentPos, yCurrentPos, zCurrentPos;
    double xCurrentPosBack, yCurrentPosBack, zCurrentPosBack; 
    double CurrentSpeed, PreviousSpeed;
    double TotalDistance;
    double SystemGenerationT;
    double SystemEntranceT;
    double SectionEntranceT;
    double CurrentStopTime;
    bool stopped;
    uint mNbLostTurnings;
    double energyState;
    bool isLost;
};

onde:

  • report: 0, OK, caso contrário é um código de erro
  • idVeh: O identificador do veículo
  • type: O tipo de veículo (carro, ônibus, caminhão, etc.).
  • idSection: O identificador da seção.
  • segment: Número do segmento da seção onde o veículo está localizado (de 0 a n-1)
  • numberLane: Número da faixa no segmento (de 1, a faixa mais à direita, a N, a faixa mais à esquerda).
  • idSectionFrom: Identificador da seção de origem.
  • idLaneFrom: Faixa da seção de origem pela qual o veículo entra no nó. 1 sendo a faixa mais à direita e N a faixa mais à esquerda, sendo N o número de faixas na seção de origem.
  • idSectionTo: Identificador da seção de destino.
  • idLaneTo: Faixa da seção de destino para a qual o veículo sai do nó. 1 sendo a faixa mais à direita e N a faixa mais à esquerda, sendo N o número de faixas na seção de destino.
  • CurrentPos: Posição dentro da seção. A distância (metros ou pés, dependendo das unidades definidas na rede) desde o início da seção ou posição dentro do nó dada como a distância da entrada até o nó.
  • distance2End: Distância até o final da seção (metros ou pés, dependendo das unidades definidas na rede) quando o veículo está localizado em uma seção ou a distância até o final da curva quando o veículo está em um nó.
  • xCurrentPos, yCurrentPos, zCurrentPos: Coordenadas mundiais do ponto médio do para-choque frontal do veículo.
  • xCurrentPosBack, yCurrentPosBack, zCurrentPosBack: Coordenadas mundiais do ponto médio do para-choque traseiro do veículo.
  • CurrentSpeed: Velocidade atual (em km/h ou mph, dependendo das unidades definidas na rede).
  • PreviousSpeed: Velocidade no passo de simulação anterior (em km/h ou mph, dependendo das unidades definidas na rede).
  • TotalDistance: Distância total percorrida (metros ou pés).
  • SystemGenerationT: O tempo absoluto de geração do veículo no sistema. Se nenhuma fila virtual encontrada em sua seção de entrada, será o mesmo que o SystemEntranceT.
  • SystemEntranceT: O tempo absoluto de entrada do veículo no sistema, ou seja, em sua seção de entrada. Se nenhuma fila virtual encontrada em sua seção de entrada, será o mesmo que o SystemGenerationT.
  • SectionEntranceT: O tempo absoluto de entrada do veículo na seção atual.
  • CurrentStopTime: O tempo atual de parada.
  • stopped: Verdadeiro se o veículo permanecer parado.
  • mNbLostTurnings: O número de curvas perdidas.
  • energyState: Nível atual do tanque de combustível em veículos de combustão (l) ou estado atual da bateria em veículos elétricos (kW)
  • isLost: Verdadeiro se o veículo estiver perdido e não puder alcançar seu destino.

Ler as Informações Estáticas de um Veículo Rastreado

Em C++ e Python

Explicação

Ler as informações estáticas do veículo rastreado. As informações estáticas são as características do veículo que foram definidas quando o veículo entrou no sistema.

Formato
StaticInfVeh AKIVehTrackedGetStaticInf (int aidVeh)
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída:
struct StaticInfVeh{
    int report;
    int idVeh;
    int type;
    double length;
    double width;
    double maxDesiredSpeed;
    double maxAcceleration;
    double normalDeceleration;
    double maxDeceleration;
    double speedAcceptance;
    double minDistanceVeh;
    double giveWayTime;
    double guidanceAcceptance;
    int enrouted;
    int equipped;
    int tracked;
    bool  keepfastLane;
    double safetyMarginFactor;
    double headwayMin;
    double sensitivityFactor;
    double reactionTime;
    double reactionTimeAtStop;
    double reactionTimeAtTrafficLight;
    bool laneChangingCooperation;
    double laneChangingAggressivenessLevel;
    double distanceZoneFactor;
    int centroidOrigin;
    int centroidDest;
    int idsectionExit;
    int idLine;
    void * internalInfo;
    int engineTypeId;
    int vehicleSegmentId;
    int EUEmissionId;
    double energyCapacity;
};

onde:

  • report: 0, OK, senão código de erro
  • idVeh: Identificador do veículo
  • type: Tipo de veículo (carro, ônibus, caminhão, etc.)
  • length: Comprimento do veículo (m ou pés, dependendo das unidades definidas na rede).
  • width: Largura do veículo (m ou pés, dependendo das unidades definidas na rede).
  • maxDesiredSpeed: Velocidade máxima desejada do veículo (km/h ou mph, dependendo das unidades definidas na rede).
  • maxAcceleration: Aceleração máxima do veículo (m/s2 ou ft/s2, dependendo das unidades definidas na rede).
  • normalDeceleration: Aceleração máxima que o veículo pode aplicar em condições normais (m/s2 ou ft/s2, dependendo das unidades definidas na rede).
  • maxDeceleration: Aceleração máxima do veículo que pode ser aplicada sob condições especiais (m/s2 ou ft/s2, dependendo das unidades definidas na rede).
  • speedAcceptance: Grau de aceitação dos limites de velocidade.
  • minDistanceVeh: Distância que o veículo mantém entre si e o veículo precedente (metros ou pés, dependendo das unidades definidas na rede).
  • giveWayTime: Tempo após o qual o veículo se torna mais agressivo em situações de dê preferência (segundos).
  • guidanceAcceptance: Nível de conformidade do veículo com as indicações de orientação.
  • enrouted: 0 significa que o veículo não atualizará o caminho em rota, 1 significa que o veículo mudará o caminho em rota dependendo da porcentagem definida de veículos que atualizam o caminho em rota.
  • equipped: 0 significa que o veículo não está equipado, 1 significa que o veículo está equipado.
  • tracked: 0 significa que o veículo não está rastreado, 1 significa que o veículo está rastreado.
  • keepfastLane: Verdadeiro significa que o veículo mantém a faixa rápida durante a ultrapassagem
  • safetyMarginFactor: Fator de margem de segurança
  • headwayMin: Intervalo mínimo até o líder
  • sensitivityFactor: Estimativa da aceleração do líder
  • reactionTime: Tempo de reação do veículo
  • reactionTimeAtStop: Tempo de reação ao parar do veículo
  • reactionTimeAtTrafficLight: Tempo de reação do veículo quando parado o primeiro da fila em um semáforo.
  • laneChangingCooperation:
  • laneChangingAggressivenessLevel:
  • distanceZoneFactor:
  • centroidOrigin: Identificador do centróide de origem do veículo, quando as condições de tráfego são definidas por uma matriz OD.
  • centroidDest: : Identificador do centróide de destino do veículo, quando as condições de tráfego são definidas por uma matriz OD.
  • idsectionExit: : Identificador da seção de saída do destino do veículo, quando o centróide de destino usa porcentagens como destino (caso contrário é –1) e as condições de tráfego são definidas por uma matriz OD.
  • idLine: Identificador da Linha de Transporte Público, quando o veículo foi gerado como um veículo de transporte público.
  • internalInfo: Para uso interno
  • engineTypeId: Identificador do tipo de motor do veículo (emissões, consumo, modelos de aceleração MFC), onde: Nenhum = 0, Gasolina = 1, Diesel = 2, Elétrico = 3, Gás = 4.
  • vehicleSegmentId: Identificador do Segmento de Carro da Euro do veículo para o modelo de aceleração MFC / modelo de Consumo de Bateria: Nenhum = 0, A = 1, B = 2, C = 3, D = 4, E = 5, F = 6, J = 7, NM = 8.
  • EUEmissionId: Identificador de Emissão Padrão para LEM. Nulo = 0, Zero = 1, Euro 0 = 2, Euro 1 = 3, Euro 2 = 4, Euro 3 = 5, Euro 4 = 6, Euro 5 = 7, Euro 6 = 8, Euro 6c = 9 (Veículos Leves (carro, táxi, van)), Euro I = 10, Euro II = 11, Euro III = 12, Euro IV = 13, Euro IV EGR = 14, Euro V = 15, Euro V EGR = 16, Euro V SCR = 17, Euro VI = 18 (Veículos Pesados (LGV, HGV, Ônibus, Microônibus)).
  • energyCapacity: Capacidade total do tanque (l) ou bateria (kW)

Modificar as Informações Estáticas de um Veículo Rastreado

Em C++ e Python

Explicação

Modificar alguns dos parâmetros estáticos de um veículo rastreado. Parâmetros estáticos são as características do veículo que foram definidas quando o veículo entrou no sistema. Os parâmetros estáticos que podem ser alterados são: tipo, comprimento, largura, maxDesiredSpeed, maxAcceleration, normalDeceleration, maxDeceleration, speedAcceptance, minDistanceVeh, giveWayTime, guidanceAcceptance, enrouted, equipped, tracked, keepfastLane, safetyMarginFactor, headwayMin, sensitivityFactor, reactionTime, reactionTimeAtStop, reactionTimeAtTrafficLight, centroidOrigin, centroidDest e idsectionExit (a seção de saída faz sentido quando o centróide de destino usa porcentagens como destino; se o identificador da seção for inválido ou –1, então Aimsun Next determinará a seção de saída de acordo com os critérios definidos no centróide). Aimsun Next não armazena os valores anteriores, portanto, não pode recuperá-los.

Formato
int AKIVehTrackedSetStaticInf (int aidVeh, StaticInfVeh staticinfVeh)
Parâmetros
  • aidVeh: O identificador do veículo rastreado.
  • staticinfVeh: Os novos parâmetros estáticos a serem atribuídos.
Saída:
  • = 0: Sem erro
  • < 0: Erro

Ler as Informações de Controle de Cruzeiro Adaptativo de um Veículo Rastreado

Em C++ e Python

Explicação

Ler as informações de Controle de Cruzeiro Adaptativo do veículo rastreado. Os parâmetros ACC estabelecem as capacidades e influenciam o comportamento do Controle de Cruzeiro Adaptativo do veículo. Esses parâmetros foram definidos quando o veículo entrou no sistema.

Formato
StaticInfVehACCParams AKIVehTrackedGetStaticInfACCParams( int aidVeh )
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída:
struct StaticInfVehACCParams {
    int report;                     
    int idVeh;
    int accType;

    double minClearanceDistance;
    double maxClearanceDistance;
    double speedGainFreeFlow;
    double distanceGain;
    double speedGainPrec;
    double desiredTimeGap;

    double connectedDistanceGain;
    double connectedSpeedGain;
    double minTimeGapThreshold;
    double maxTimeGapThreshold;
    double followerTimeGap;
    double leaderTimeGap;
};

onde:

Parâmetros comuns a todos os veículos simulados:

  • report: Código de erro retornado (0 significa sucesso).
  • idVeh: O ID do veículo simulado.
  • accType: O módulo ACC do veículo simulado (0: Nenhum, 1: ACC, 2: CACC).

Parâmetros do Modelo ACC:

(Todos esses parâmetros serão -1 quando o módulo estiver desativado)

  • minClearanceDistance: O limite inferior para o espaço entre o para-choque traseiro de um veículo e o para-choque dianteiro do seguinte (m).
  • maxClearanceDistance: O limite superior para o espaço entre o para-choque traseiro de um veículo e o para-choque dianteiro do seguinte (m).
  • speedGainFreeFlow: O ganho na diferença de velocidade entre a velocidade de fluxo livre e a velocidade atual do veículo sujeito (s-1).
  • distanceGain: O ganho na diferença de posição entre o veículo precedente e o veículo sujeito (s-2).
  • speedGainPrec: O ganho na diferença de velocidade entre o veículo precedente e o veículo sujeito (s-1).
  • desiredTimeGap: O intervalo de tempo desejado do controlador ACC (s).

Parâmetros do Modelo CACC:

(Todos esses parâmetros serão -1 quando o módulo estiver desativado)

  • connectedDistanceGain: O ganho na diferença de posição entre o veículo conectado precedente e o veículo CACC sujeito (s-1).
  • connectedSpeedGain: O ganho na diferença de velocidade entre o veículo conectado precedente e o veículo CACC sujeito.
  • minTimeGapThreshold: O limite inferior para o intervalo de tempo (s).
  • maxTimeGapThreshold: O limite superior para o intervalo de tempo (s).
  • followerTimeGap: O intervalo de tempo constante entre o último veículo da sequência conectada precedente e o veículo CACC sujeito (s).
  • leaderTimeGap: O intervalo de tempo constante entre o último veículo da sequência conectada precedente e o veículo CACC sujeito (s).

Modificar as Informações de Controle de Cruzeiro Adaptativo de um Veículo Rastreado

Em C++ e Python

Explicação

Modificar os parâmetros ACC de um veículo rastreado. Os parâmetros ACC estabelecem as capacidades e influenciam o comportamento do Controle de Cruzeiro Adaptativo do veículo. Esses parâmetros foram definidos quando o veículo entrou no sistema. Todos os parâmetros podem ser alterados, exceto idVeh e report. Aimsun Next não armazena os valores anteriores, portanto, não pode recuperá-los.

Formato
int AKIVehTrackedSetStaticInfACCParams( int aidVeh, StaticInfVehACCParams staticinfVehACC )
Parâmetros
  • aidVeh: O identificador do veículo rastreado.
  • staticinfVehACC: Os novos parâmetros ACC a serem atribuídos.
Saída:
  • = 0: Sem erro
  • < 0: Erro

Ler a(s) posição(ões) de um Veículo Rastreado

Em C++ e Python

Explicação

Ler as coordenadas do veículo rastreado durante o último passo de simulação.

Formato
InfVehPos AKIVehTrackedGetPos( int anIdVeh, int nbPos )
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • nbPos: Número de posições do veículo rastreado. Se este parâmetro for maior que 1, a função fornece as posições "entre o passo de simulação" para este veículo. A última posição sempre corresponde à posição no final do passo de simulação.
Saída:
struct InfVehPos{
    int report;
    int idVeh;
    int Npos;
    VehPos *vehiclePos;
};

struct VehPos{
    double xPos, yPos, zPos;
    double xPosBack, yPosBack, zPosBack;
};

onde:

  • report: 0, OK, caso contrário um código de erro.
  • idVeh: O identificador do veículo.
  • Npos: Número de posições durante o último passo de simulação (parâmetro de entrada).
  • vehiclePos: Array com as posições durante o último passo de simulação. Após usar esta função, este array deve ser desalocado usando a função "free".
  • xPos, yPos, zPos: Coordenadas mundiais do ponto médio do para-choque frontal do veículo para a posição atual.
  • xPosBack, yPosBack, zPosBack: Coordenadas mundiais do ponto médio do para-choque traseiro do veículo para a posição atual.
Uso em Python

A estrutura VehPos * é mapeada como um VehPosArray. Para acessá-la corretamente, o VehPosArray precisa ser construído a partir da estrutura vehiclePos. Veja o código a seguir como um exemplo:

currentState = AKIVehTrackedGetPos(1, 4)
if currentState.report == 0:
    vehiclePos = VehPosArray.frompointer(currentState.vehiclePos)
    for i in range(currentState.Npos):
        print (time,vehiclePos[i].xPos, vehiclePos[i].yPos, vehiclePos[i].zPos)

Modificar a posição de um Veículo Rastreado

Em C++ e Python

Explicação

Modificar a posição do veículo rastreado durante o último passo de simulação, considerando as coordenadas mundiais no ponto médio dos para-choques frontal e traseiro do veículo.

Formato
int AKIVehSetVehicleTrackedDynInf( int anIdVeh, DynInfVeh dynInfVeh)
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
  • dynInfVeh: As informações dinâmicas durante o último passo de simulação onde:

    struct dynInfVeh{ double xCurrentPos, yCurrentPos; double xCurrentPosBack, yCurrentPosBack; double currentSpeed; int turning; }; - xCurrentPos, yCurrentPos: Coordenadas mundiais do ponto médio do para-choque frontal do veículo para a posição atual - xCurrentPosBack, yCurrentPosBack: Coordenadas mundiais do ponto médio do para-choque traseiro do veículo para a posição atual - currentSpeed: Velocidade atual (km/h ou mph, dependendo das unidades definidas na rede). - turning: Próxima curva selecionada pelo veículo (-1 curva à direita, 1 curva à esquerda, 0 outros casos)

Saída:
  • = 0: Sem erro
  • < 0: Erro

Ler a posição relativa ao líder de um Veículo Rastreado

Em C++ e Python

Explicação

Ler a posição relativa ao líder

Formato
LeaderInfVeh AKIVehTrackedGetLeaderVehInf(int aidVeh);
Parâmetros
  • aidVeh: Identificador do veículo
Saída
struct LeaderInfVeh{
    int report;
    int idVeh;
    int idLeaderVeh; 
    double headway;
    double gap;
    double spacing;
    double clearance;
};

onde:

  • report: 0, OK, senão código de erro
  • idVeh: identificador do veículo
  • idLeaderVeh: identificador do veículo líder, 0 se não houver líder.
  • headway: tempo entre o para-choque frontal de um veículo e o para-choque frontal do próximo veículo (s).
  • gap: tempo entre o para-choque traseiro de um veículo e o para-choque frontal do próximo veículo (s).
  • spacing: espaço entre o para-choque frontal de um veículo e o para-choque frontal do próximo veículo (m).
  • clearance: espaço entre o para-choque traseiro de um veículo e o para-choque frontal do próximo (m).

Ler as Informações Gráficas de um Veículo Rastreado

Em C++ e Python

Explicação

Ler as informações gráficas do veículo rastreado durante o último passo de simulação.

Formato
GraphicInfVeh AKIVehTrackedGetGraphicInf ( int anIdVeh)
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída:
struct GraphicInfVeh{
    int report;
    int idVeh;
    bool leftTurnSignal;
    bool rightTurnSignal;
    bool brakeLight;
}

Ler o identificador da categoria do veículo

Em C++ e Python

Explicação

Ler o identificador da categoria estática do veículo: Usado para classificar a categoria do veículo.

Formato
int AKIVehTrackedGetVehicleCategoryId ( int anIdVeh )
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída:

int vehicleCategory{ 0 = Carro 1 = Veículo Comercial 2 = Ônibus 3 = Motocicleta 4 = Não Motorizado };

Ler o identificador do tipo de emissão do veículo para o Modelo de Emissão de Londres (LEM).

Em C++ e Python

Explicação

Ler o identificador de emissão estática do veículo: Usado para classificar o tipo de emissão do veículo (subtipo da categoria do veículo).

Formato
int AKIVehTrackedGetLEMEmissionVehicleTypeId ( int anIdVeh )
Parâmetros
  • aidVeh: Identificador do veículo rastreado.
Saída:

int SSLEMVehicleTypeID{ 0 = Carro 1 = Táxi 2 = eLGV 3 = eHGV 4 = eÔnibus de andar simples 5 = eÔnibus de andar duplo 6 = eMicro-ônibus };

Ler o número de seções para alcançar o destino

Em C++ e Python

Explicação

Ler o número de seções para alcançar o destino de um caminho de veículo rastreado. Válido para veículos OD e de Transporte Público, caso contrário retorna 0.

Formato
int AKIVehTrackedGetNbSectionsVehiclePath( int idveh )
Parâmetros
  • idveh: O identificador do veículo rastreado.
Saída:
  • ≥ 0: Número de seções para alcançar o destino.
  • AKIVehNotTracked: Erro

Ler os Identificadores das Seções usadas para alcançar o Destino

Em C++ e Python

Explicação

Ler o identificador da seção elem-th do caminho do veículo rastreado para alcançar o destino. Válido para veículos OD e de Transporte Público, caso contrário retorna 0. AKIVehTrackedGetNbSectionsVehiclePath deve ser chamado antes de chamar esta função.

Formato
int AKIVehTrackedGetIdSectionVehiclePath( int idveh, int indexsection )
Parâmetros
  • idveh: O identificador do veículo rastreado.
  • indexsection: Índice da seção ( 0 ≤ indexsection < Número de seções )
Saída:
  • > 0: Identificador da Seção.
  • AKIVehNotTracked: Erro

Definir a trajetória do veículo com base nas faixas

Em C++ e Python

Explicação

Função para atribuir uma trajetória com base em faixas específicas nas seções.

Formato
int AKIVehTrackedSetLanesTrajectory(int idVehicle, int nbSegmentsInTrajectory, int * sectIds, int * lanes, int idLastSection)
Parâmetros
  • idVehicle: Identificador do veículo.
  • nbSegmentsInTrajectory: Número de pares diferentes de id de seção + id de faixa que farão parte da trajetória com base nas faixas.
  • sectIds: vetor de nbSegmentsInTrajectory de identificadores de seção.
  • lanes: vetor de nbSegmentsInTrajectory de identificadores de faixa na mesma posição que a seção que referenciam. Os ids de faixa vão de 1...N, sendo 1 a faixa mais à direita e N a faixa mais à esquerda.
  • idLastSection: id do identificador da última seção na trajetória.
Saída
  • 0: Sem erro

Código de exemplo em Python

sectIds = intArray( 3 )
sectIds[0] = 182
sectIds[1] = 183
sectIds[2] = 184
laneIds = intArray( 3 )
laneIds[0] = 1
laneIds[1] = 2
laneIds[2] = 1
AKIVehTrackedSetLanesTrajectory(idVehicle, 3, sectIds, laneIds, 184)