Partilhar via


RouteInstructionOutput interface

Um conjunto de atributos que descrevem uma manobra, por exemplo, «Vire à direita», «Mantenha-se à esquerda», «Apanhe o ferry», «Apanhe a autoestrada», «Chegar».

Propriedades

combinedMessage

Uma mensagem legível por humanos para a manobra combinada com a mensagem da próxima instrução. Às vezes, é possível combinar duas instruções sucessivas em uma única instrução, tornando mais fácil de seguir. Quando este for o caso, o sinalizador possibleCombineWithNext será true. Por exemplo:

10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam

O sinalizador possibleCombineWithNext na instrução 10 é true. Isso indica aos clientes da orientação codificada que ela pode ser combinada com a instrução 11. As instruções serão combinadas automaticamente para clientes que solicitem orientação legível por humanos. O campo combinedMessage contém a mensagem combinada:

Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
then follow Einsteinweg/A10/E22 towards Ring Amsterdam.
countryCode

3 caracteres código de país ISO 3166-1 alpha-3. Por exemplo, EUA.

drivingSide

Indica a condução à esquerda vs. à direita no ponto da manobra.

exitNumber

O(s) número(s) de uma saída de rodovia tomada pela manobra atual. Se uma saída tiver vários números de saída, eles serão separados por "," e possivelmente agregados por "-", por exemplo, "10, 13-15".

instructionType

Tipo de instrução, por exemplo, virar ou mudar de forma de estrada.

junctionType

O tipo de entroncamento onde ocorre a manobra. Para rotundas maiores, são geradas duas instruções separadas para entrar e sair da rotunda.

maneuver

Um código que identifica a manobra.

message

Uma mensagem legível por humanos para a manobra.

point

Um local representado como latitude e longitude.

pointIndex

O índice do ponto na lista de "pontos" de polilinha correspondente ao ponto da instrução.

possibleCombineWithNext

Opcionalmente, é possível combinar a instrução com a próxima. Isso pode ser usado para criar mensagens como "Vire à esquerda e depois vire à direita".

roadNumbers

Número(s) de estrada do(s) próximo(s) segmento(s) de estrada significativo(s) após a manobra, ou da(s) estrada(s) a seguir. Exemplo: ["E34", "N205"]

roundaboutExitNumber

Isso indica qual saída tomar em uma rotatória.

routeOffsetInMeters

Distância desde o início do percurso até ao ponto da instrução.

signpostText

O texto em uma placa de sinalização que é mais relevante para a manobra, ou para a direção que deve ser seguida.

stateCode

Uma subdivisão (por exemplo, estado) do país, representada pela segunda parte de um código ISO 3166-2. Isso só está disponível para alguns países/regiões, como EUA, Canadá e México.

street

Nome da rua do próximo segmento significativo da estrada após a manobra, ou da rua que deve ser seguida.

travelTimeInSeconds

Tempo de viagem estimado até o ponto correspondente a routeOffsetInMeters.

turnAngleInDecimalDegrees

Indica a direção de uma instrução. Se junctionType indicar uma instrução de volta:

  • 180 = Retorno em U
  • [-179, -1] = Virar à esquerda
  • 0 = Em linha reta (uma volta de '0 grau')
  • [1, 179] = Virar à direita

Se junctionType indicar uma instrução de bifurcação:

  • <0 - mantenha-se à esquerda
  • >0 - mantenha-se à direita

Detalhes de Propriedade

combinedMessage

Uma mensagem legível por humanos para a manobra combinada com a mensagem da próxima instrução. Às vezes, é possível combinar duas instruções sucessivas em uma única instrução, tornando mais fácil de seguir. Quando este for o caso, o sinalizador possibleCombineWithNext será true. Por exemplo:

10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam

O sinalizador possibleCombineWithNext na instrução 10 é true. Isso indica aos clientes da orientação codificada que ela pode ser combinada com a instrução 11. As instruções serão combinadas automaticamente para clientes que solicitem orientação legível por humanos. O campo combinedMessage contém a mensagem combinada:

Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
then follow Einsteinweg/A10/E22 towards Ring Amsterdam.
combinedMessage?: string

Valor de Propriedade

string

countryCode

3 caracteres código de país ISO 3166-1 alpha-3. Por exemplo, EUA.

countryCode?: string

Valor de Propriedade

string

drivingSide

Indica a condução à esquerda vs. à direita no ponto da manobra.

drivingSide?: "LEFT" | "RIGHT"

Valor de Propriedade

"LEFT" | "RIGHT"

exitNumber

O(s) número(s) de uma saída de rodovia tomada pela manobra atual. Se uma saída tiver vários números de saída, eles serão separados por "," e possivelmente agregados por "-", por exemplo, "10, 13-15".

exitNumber?: string

Valor de Propriedade

string

instructionType

Tipo de instrução, por exemplo, virar ou mudar de forma de estrada.

instructionType?: "TURN" | "ROAD_CHANGE" | "LOCATION_DEPARTURE" | "LOCATION_ARRIVAL" | "DIRECTION_INFO" | "LOCATION_WAYPOINT"

Valor de Propriedade

"TURN" | "ROAD_CHANGE" | "LOCATION_DEPARTURE" | "LOCATION_ARRIVAL" | "DIRECTION_INFO" | "LOCATION_WAYPOINT"

junctionType

O tipo de entroncamento onde ocorre a manobra. Para rotundas maiores, são geradas duas instruções separadas para entrar e sair da rotunda.

junctionType?: "REGULAR" | "ROUNDABOUT" | "BIFURCATION"

Valor de Propriedade

"REGULAR" | "ROUNDABOUT" | "BIFURCATION"

maneuver

Um código que identifica a manobra.

maneuver?: "ARRIVE" | "ARRIVE_LEFT" | "ARRIVE_RIGHT" | "DEPART" | "STRAIGHT" | "KEEP_RIGHT" | "BEAR_RIGHT" | "TURN_RIGHT" | "SHARP_RIGHT" | "KEEP_LEFT" | "BEAR_LEFT" | "TURN_LEFT" | "SHARP_LEFT" | "MAKE_UTURN" | "ENTER_MOTORWAY" | "ENTER_FREEWAY" | "ENTER_HIGHWAY" | "TAKE_EXIT" | "MOTORWAY_EXIT_LEFT" | "MOTORWAY_EXIT_RIGHT" | "TAKE_FERRY" | "ROUNDABOUT_CROSS" | "ROUNDABOUT_RIGHT" | "ROUNDABOUT_LEFT" | "ROUNDABOUT_BACK" | "TRY_MAKE_UTURN" | "FOLLOW" | "SWITCH_PARALLEL_ROAD" | "SWITCH_MAIN_ROAD" | "ENTRANCE_RAMP" | "WAYPOINT_LEFT" | "WAYPOINT_RIGHT" | "WAYPOINT_REACHED"

Valor de Propriedade

"ARRIVE" | "ARRIVE_LEFT" | "ARRIVE_RIGHT" | "DEPART" | "STRAIGHT" | "KEEP_RIGHT" | "BEAR_RIGHT" | "TURN_RIGHT" | "SHARP_RIGHT" | "KEEP_LEFT" | "BEAR_LEFT" | "TURN_LEFT" | "SHARP_LEFT" | "MAKE_UTURN" | "ENTER_MOTORWAY" | "ENTER_FREEWAY" | "ENTER_HIGHWAY" | "TAKE_EXIT" | "MOTORWAY_EXIT_LEFT" | "MOTORWAY_EXIT_RIGHT" | "TAKE_FERRY" | "ROUNDABOUT_CROSS" | "ROUNDABOUT_RIGHT" | "ROUNDABOUT_LEFT" | "ROUNDABOUT_BACK" | "TRY_MAKE_UTURN" | "FOLLOW" | "SWITCH_PARALLEL_ROAD" | "SWITCH_MAIN_ROAD" | "ENTRANCE_RAMP" | "WAYPOINT_LEFT" | "WAYPOINT_RIGHT" | "WAYPOINT_REACHED"

message

Uma mensagem legível por humanos para a manobra.

message?: string

Valor de Propriedade

string

point

Um local representado como latitude e longitude.

point?: LatLongPairOutput

Valor de Propriedade

pointIndex

O índice do ponto na lista de "pontos" de polilinha correspondente ao ponto da instrução.

pointIndex?: number

Valor de Propriedade

number

possibleCombineWithNext

Opcionalmente, é possível combinar a instrução com a próxima. Isso pode ser usado para criar mensagens como "Vire à esquerda e depois vire à direita".

possibleCombineWithNext?: boolean

Valor de Propriedade

boolean

roadNumbers

Número(s) de estrada do(s) próximo(s) segmento(s) de estrada significativo(s) após a manobra, ou da(s) estrada(s) a seguir. Exemplo: ["E34", "N205"]

roadNumbers?: string[]

Valor de Propriedade

string[]

roundaboutExitNumber

Isso indica qual saída tomar em uma rotatória.

roundaboutExitNumber?: number

Valor de Propriedade

number

routeOffsetInMeters

Distância desde o início do percurso até ao ponto da instrução.

routeOffsetInMeters?: number

Valor de Propriedade

number

signpostText

O texto em uma placa de sinalização que é mais relevante para a manobra, ou para a direção que deve ser seguida.

signpostText?: string

Valor de Propriedade

string

stateCode

Uma subdivisão (por exemplo, estado) do país, representada pela segunda parte de um código ISO 3166-2. Isso só está disponível para alguns países/regiões, como EUA, Canadá e México.

stateCode?: string

Valor de Propriedade

string

street

Nome da rua do próximo segmento significativo da estrada após a manobra, ou da rua que deve ser seguida.

street?: string

Valor de Propriedade

string

travelTimeInSeconds

Tempo de viagem estimado até o ponto correspondente a routeOffsetInMeters.

travelTimeInSeconds?: number

Valor de Propriedade

number

turnAngleInDecimalDegrees

Indica a direção de uma instrução. Se junctionType indicar uma instrução de volta:

  • 180 = Retorno em U
  • [-179, -1] = Virar à esquerda
  • 0 = Em linha reta (uma volta de '0 grau')
  • [1, 179] = Virar à direita

Se junctionType indicar uma instrução de bifurcação:

  • <0 - mantenha-se à esquerda
  • >0 - mantenha-se à direita
turnAngleInDecimalDegrees?: number

Valor de Propriedade

number