Aimsun Next API Informações de Tipos de Veículo¶

Funções relacionadas a Informações de Tipos de Veículos¶

Ler Número de Tipos de Veículos¶

Em C++ e Python¶

Explicação¶

Lê o número total de tipos de veículos. Se Transit estiver modelado, isso inclui os tipos de veículos de transporte coletivo.

Formato¶

int AKIVehGetNbVehTypes ()

Parâmetros¶

None

Saída¶

• > 0: Número total de tipos de veículos
• < 0: Erro

Ler o Nome de um Tipo de Veículo¶

Em C++ e Python¶

Explicação¶

Lê o nome de um vehicle Type em utf16 e terminado por \0. O resultado deve ser excluído com delete().

Formato:¶

const unsigned short *AKIVehGetVehTypeName(int vehTypePos);

Parâmetros¶

• vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso no intervalo de 1 a AKIVehGetNbVehTypes (), para um tipo de veículo específico.

Saída¶

• ≠ NULL: nome do tipo de veículo
• = NULL: Erro

O uso recomendado em APIs Python é:

anyNonAsciiChar = boolp()
AKIConvertToAsciiString(AKIVehGetVehTypeName(vehTypePos), True, anyNonAsciiChar))

Ler o ID do tipo de veículo usando a posição de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Leia o ID do tipo de veículo dada a posição do tipo de veículo na lista de tipos de veículos.

Formato¶

int AKIVehTypeGetIdVehTypeANG (int vehTypePos );

Parâmetros¶

• vehTypePos A posição do tipo de veículo na lista de tipos de veículos em uso, no intervalo de 1 a AKIVehGetNbVehTypes (), para um tipo de veículo específico.

Saída¶

• >0: O ID do tipo de veículo
• -1: Nenhum tipo de veículo com a posição fornecida foi encontrado

Ler a posição de um tipo de veículo usando o ID do tipo de veículo ¶

Em C++ e Python¶

Explicação¶

Ler a posição de um Type de veículo dado o identificador do tipo de veículo.

Formato:¶

int AKIVehGetVehTypeInternalPosition (int aimsunVehicleTypeId );

Parâmetros¶

• aimsunVehicleTypeId: O identificador do tipo de veículo.

Saída¶

• > 0: Um valor de 1 até o número total de tipos de veículo
• < 0: Nenhum veículo com o nome fornecido encontrado

Ler a posição de um tipo de veículo usando o nome do tipo de veículo¶

O nome de um tipo de veículo, por ser editado pelo usuário, pode não ser único. No entanto, o ID é sempre único. Portanto, recomenda-se que AKIVehGetVehTypeInternalPosition seja usado conforme explicado acima para obter a posição de um tipo de veículo.

Se houver necessidade de acessar a posição do tipo de veículo a partir do nome do tipo de veículo, as seguintes funções podem ser usadas. Por exemplo, para obter a posição interna veh para o tipo de veículo 'car' em uma API Python, o código seria:

idVeh = ANGConnGetObjectIdByType( AKIConvertFromAsciiString( "car" ), AKIConvertFromAsciiString( "GKVehicle" ), False )
vehPos = AKIVehGetVehTypeInternalPosition( idVeh )

Isto usa o ANGConnGetObjectIdByType função e o AKIVehGetVehTypeInternalPosition

Ler o comprimento mínimo e máximo de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Ler o comprimento mínimo e máximo do tipo de veículo

Formato¶

double AKIVehGetMinLengthVehType (int vehTypePos)
double AKIVehGetMaxLengthVehType (int vehTypePos)

Parâmetros¶

• vehTypePos A posição do tipo de veículo na lista de tipos de veículos em uso. 0 é usado para todos os tipos de veículos e um valor de 1 a AKIVehGetNbVehTypes (), para um tipo de veículo específico.

Saída¶

• > 0: O comprimento mínimo e o comprimento máximo do tipo de veículo.
• < 0: Erro

Ler se o comportamento imprudente de mudança de faixa está ativado ou não¶

Em C++ e Python¶

Explicação¶

Lê se um tipo de veículo tem o comportamento Imprudent Lane-changing ativado.

Formato¶

bool AKIVehTypeGetImprudentLaneChanging( int idVehicleType )

Parâmetros¶

• idVehicleType: Identificador do Tipo de veículo.

Saída¶

• Verdadeiro: O tipo de veículo tem o comportamento de mudança de faixa imprudente ativo.
• False: O tipo de veículo não tem o comportamento de mudança imprudente de faixa ativo.

Ativar/desativar o comportamento imprudente de mudança de faixa de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Ativa/desativa o comportamento de mudança de faixa imprudente de um tipo de veículo.

Formato¶

int AKIVehTypeSetImprudentLaneChanging( int idVehType, bool value )

Parâmetros¶

• idVehType: Identificador do Tipo de veículo.
• valor: True para ativar o comportamento de mudança de faixa imprudente, false caso contrário.

Saída¶

• 0: OK
• < 0: Erro

Ler a porcentagem de permanência na faixa rápida de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Lê a porcentagem especificada para permanecer em uma faixa rápida após uma mudança de faixa de um tipo de veículo.

Formato¶

double AKIVehTypeGetPercentageForStayingInFastLane ( int idVehType )

Parâmetros:

• idVehType: Identificador do Tipo de veículo.

Saída¶

• > 0: A porcentagem do tipo de veículo para permanecer na faixa rápida após uma ultrapassagem.
• < 0: Erro

Modificar a porcentagem de permanência na faixa rápida de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Modifica a porcentagem especificada para permanecer em uma faixa rápida após uma mudança de faixa de um tipo de veículo.

Formato¶

int AKIVehTypeSetPercentageForStayingInFastLane ( int idVehType, double newPercentage )

Parâmetros¶

• idVehType Identificador do Tipo de veículo.
• newPercentage: Valor entre 0 e 100 para definir o novo percentual que será usado a partir do momento em que a função for chamada.

Saída¶

• 0: OK
• < 0: Erro

Ler o Limiar de Velocidade de Ultrapassagem de um Tipo de Veículo¶

Em C++ e Python¶

Explicação¶

Lê o limite de velocidade de ultrapassagem de um tipo de veículo.

Formato¶

double AKIVehTypeGetOvertakeSpeedThreshold ( int idVehType )

Parâmetros¶

• idVehType: Identificador do Tipo de veículo.

Saída¶

• > 0: O limiar de velocidade de ultrapassagem do tipo de veículo.
• < 0: Erro

Modificar o limiar de velocidade de ultrapassagem de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Modifica o limite de velocidade de ultrapassagem de um tipo de veículo.

Formato¶

int AKIVehTypeSetOvertakeSpeedThreshold ( int idVehicleType, double newPercentage )

Parâmetros¶

• idVehType: Identificador do Tipo de veículo.
• newPercentage: Valor entre 0 e 100 para definir o novo limite de velocidade de ultrapassagem que será usado a partir do momento em que a função for chamada.

Saída¶

• 0: OK
• < 0: Erro

Ler o limiar de velocidade de recuperação de faixa de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Lê o limite de velocidade de recuperação de faixa de um tipo de veículo.

Formato¶

double AKIVehTypeGetLaneRecoverySpeedThreshold ( int idVehType )

Parâmetros¶

• idVehType: Identificador do Tipo de veículo.

Saída¶

• > 0: O limite de velocidade de recuperação de faixa do tipo de veículo.
• < 0: Erro

Modificar o limiar de velocidade de recuperação de faixa de um tipo de veículo¶

Em C++ e Python¶

Explicação¶

Modifica o limiar de velocidade de recuperação de faixa de um tipo de veículo.

Formato¶

int AKIVehTypeSetLaneRecoverySpeedThreshold ( int idVehicleType, double newPercentage )

Parâmetros¶

• idVehType: Identificador do Tipo de veículo.
• newPercentage: Valor entre 0 e 100 para definir o novo limiar de velocidade de recuperação de faixa que será usado a partir do momento em que a função for chamada.

Saída¶

• 0: OK
• < 0: Erro