Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • startDate: Número inteiro com a data e horário de referência para o parâmetro useRealSpeedsseja true. Caso não use o parâmetro useRealSpeeds, startDate poderá ser qualquer número inteirono formato timestamp.

  • calculationMode: Indica o modo de cálculo para a rota. Suporta os tipos:

    • THE_FASTEST: considera o caminho mais rápido.

    • THE_SHORTEST: considera o caminho com menor kilometragem.

  • destinations: Descrição dos pontos de destino com:

    • siteId: Identificador do ponto de parada.

    • latitude: coordenada da latitude em graus decimais.

    • longitude: coordenada da longitude em graus decimais.

  • origins: Descrição dos pontos de origem com:

    • siteId: Identificador do ponto de parada.

    • latitude: coordenada da latitude em graus decimais.

    • longitude: coordenada da longitude em graus decimais.

  • tripProfileIdentificador do perfil para realizar a rota. Ver mais em profileName. Somente será considerado os parâmetros do profile caso não estejam explicitamente declarados na request. Exemplo: se a request tiver áreas de restrição, não será considerado o do Trip Profile.

...

Code Block
{
    "calculationMode": "THE_FASTEST",
    "destinations": [
        {
            "latitude": -23.5654032561402303338195, 
            "longitude": -46.6211700463862145421187,
            "siteId": "destination1Cambucidestination1Liberdade"
        }
    ],
    "origins": [
        {
            "latitude": -23.5866431755363650451996,
            "longitude": -46.63833618620810158377516,
            "siteId": "origin1VilaMarianaorigin1Mooca"
        }
    ],
    "startDate": 0,
    "tripProfile": "MAPLINKBR"
}

...

  • restrictionZones: Array com o texto do nome da área de restrição previamente cadastradas na Restriction Zone API.

  • speedPreferences: Usado para personalizar a velocidade da via para o cálculo da rota e suas estimativas. Os argumentos possíveis são:

    • roadType: tipo de segmento da via. Valores permitidos: [ FERRY, PENALIZED_LOCAL_ROAD, LOCAL_ROAD, PENALIZED_SECONDARY_ROAD, SECONDARY_ROAD, PENALIZED_MAIN_ROAD, MAIN_ROAD, EXPRESSWAY, HIGHWAY ].

    • speed: Número inteiro com a velocidade personalizada da via.

    • speedAtToll: Número inteiro com a velocidade personalizada da via que há pedágio.

    useRealSpeeds: Habilita informações de trânsito histórico para o cálculo da Trip
    • .

    As velocidades vão se basear no trânsito do horário configurado em startDate
  • vehicleSpecification: Especificação do veículo como peso, altura, tipo de carga etc.

    • loadTypes: Texto com o tipo de carga. Usado apenas para descrição, não interfere no cálculo da rota. Valores possíveis: [ GOODS, PERSONS, AGRICULTURAL_PRODUCTS, COAL, BUILDING_PRODUCTS, HEALTH_WASTES, SAND_GRAVELS, RAW_MATERIALS, NATURAL_RESOURCES ].

    • maxHeight: Número decimal com a altura do veículo em metros. Interfere na rota, podendo pegar acesso para evitar passar por viadutos.

    • maxLength: Número decimal com a extensão do veículo em metros.

    • maxWeight: Número decimal com a capacidade de peso do veículo em toneladas.

    • maxWidth: Número decimal com a largura do veículo metros.

...

Code Block
languagejson
{
    "startDate": 1564509260,
    "profileName": "MAPLINKBR",
    "points": [
        {
            "siteId": "Point 1-Extrema",
            "latitude": -22.859246,
            "longitude": -46.339289
        },
        {
            "siteId": "Point 2-Betim",
            "latitude": -19.985117,
            "longitude": -44.202667
        }
    ],
    "calculationMode": "THE_FASTEST",
    "useRealSpeeds": false,
    "vehicleSpecification": {
        "maxHeight": 5.90,
        "maxLength": 30,
        "maxWidth": 3.60,
        "maxWeight": 150
    },
    "restrictionZones": [
        "MG_BR381_530_km_AltCentl_5_75",
        "MG_BR381_620_km_AltCentl_5_61"
    ],
    "speedPreferences": [
        {
            "roadType": "FERRY",
            "speed": 20,
            "speedAtToll": 20
        },
        {
            "roadType": "PENALIZED_LOCAL_ROAD",
            "speed": 20,
            "speedAtToll": 20
        },
        {
            "roadType": "LOCAL_ROAD",
            "speed": 30,
            "speedAtToll": 20
        },
        {
            "roadType": "PENALIZED_SECONDARY_ROAD",
            "speed": 30,
            "speedAtToll": 30
        },
        {
            "roadType": "SECONDARY_ROAD",
            "speed": 30,
            "speedAtToll": 30
        },
        {
            "roadType": "PENALIZED_MAIN_ROAD",
            "speed": 30,
            "speedAtToll": 30
        },
        {
            "roadType": "MAIN_ROAD",
            "speed": 30,
            "speedAtToll": 30
        },
        {
            "roadType": "EXPRESSWAY",
            "speed": 50,
            "speedAtToll": 50
        },
        {
            "roadType": "HIGHWAY",
            "speed": 50,
            "speedAtToll": 50
        }
    ]
}

Parâmetros Descontinuados:

  • useRealSpeeds: Habilita informações de trânsito histórico para o cálculo da Trip. As velocidades vão se basear no trânsito do horário configurado em startDate.

Info

Nota: o useRealSpeeds funciona com o perfil descontinuado “BRAZIL”, porém não funciona com o perfil “MAPLINKBR” até a data deste documento (13/04/2021).

Parâmetros Não Testados:

Code Block
languagejson
    "vehicleSpecification": {
        "maxLengthBetweenAxles": 1.8,
        "maxWeightForDangerousMaterials": 14,
        "maxWeightForExplodingMaterials": 10,
        "maxWeightForPollutingMaterials": 5.5,
        "maxWeightPerAxle": 5.2
    }

...