A Planning API é responsável por retornar a ordenação dos pontos logísticos da forma mais otimizada possível, mas podemos utilizá-la com a Trip API para obter também a melhor rota entre os pontos.
Neste exemplo, temos uma requisição para Planning API com integração a Trip API para resolver um problema logístico de 2 veículos e 10 operações, partindo do centro de distribuição.
Parâmetros utilizados
Planning:
"optimizationProfile": "BRAZIL46". Para essa simulação, foi usado o perfil de otimização BRAZIL46. Para os tipos disponíveis, verifique em optimizationProfile.
"tripsProfile": "MAPLINKBR". Utilizamos o perfil que contém o mapa mais atualizado e configurado para utilizar o modo de cálculo para utilizar vias mais rápidas.
"startDate": "1620298800000". Horário de início de referência para o cálculo da otimização logística.
"legislationProfiles": Parâmetro com o nome do perfil que se aplica ao tempo de direção, duração de um dia de trabalho ou intervalo. Neste caso não há nenhuma característica definida.
"logisticConstraints": Restrições logísticas usadas para determinar o tempo fixo de carregamento e descarregamento da carga. Nesse exemplo, foi usado 1800 segundos (30 minutos) para o tempo de carregamento do caminhão e 300 segundos (5 minutos) para o descarregamento na entrega.
"products": Nome para referenciar o produto.
"sites": Localização onde ocorrerão as atividades de entregas, com definição do nome e a restrição logística com o tempo de entrega.
"depots": Localização do centro de distribuição, com definição do nome e a restrição logística com o tempo de carregamento do caminhão.
"vehicleTypes" : Neste parâmetro especificamos a capacidade de carga dos veículos da frota, como volume e peso máximos e o tamanho dentro de um intervalo de 1 a 9, e o nome da tipologia.
"vehicles": Foram especificados os veículos que estão disponíveis para executar a rota. Se define também o período de trabalho e o perfil de legislação aplicável ao motorista. Foi definido que os veículos sairão e retornarão ao centro de distribuição.
"operations" : São as características das operações de entregas, definindo o local, peso e volume, produto, tipo de atividade, centro de distribuição da origem do produto e o horário que o cliente irá receber.
Trip:
"calculationMode" : Foi definido que o módulo de cálculo da rota seria o mais rápido (“THE FASTEST”).
"crossedBorders": Indica o retorno das cidades que a rota cruzará.
"toll": Indica que a rota deverá informar o cálculo do pedágio.
"freight": Foram definidos os parâmetros que retornam os cálculos referente ao Piso Mínimo do Frete.
Request
{
"optimizationProfile": "BRAZIL46",
"tripsProfile": "MAPLINKBR",
"startDate": 1620298800000,
"legislationProfiles": [
{
"name": "DEFAULT"
}
],
"logisticConstraints": [
{
"name": "P1Pickup",
"siteLoadingFixedTime": 1800
},
{
"name": "P1Delivery",
"siteUnloadingFixedTime": 300
}
],
"products": [
{
"name": "DEFAULT"
}
],
"sites": [
{
"name": "Cliente1",
"coordinates": {
"latitude": -23.507608,
"longitude": -46.587145
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente2",
"coordinates": {
"latitude": -23.621059,
"longitude": -46.756193
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente3",
"coordinates": {
"latitude": -23.44935,
"longitude": -46.588822
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente4",
"coordinates": {
"latitude": -23.751801,
"longitude": -46.698468
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente5",
"coordinates": {
"latitude": -23.520565,
"longitude": -46.508478
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente6",
"coordinates": {
"latitude": -23.506592,
"longitude": -46.524707
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente7",
"coordinates": {
"latitude": -23.646993,
"longitude": -46.779077
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente8",
"coordinates": {
"latitude": -23.373816,
"longitude": -46.57777
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente9",
"coordinates": {
"latitude": -23.476158,
"longitude": -46.640241
},
"logisticConstraints": "P1Delivery"
},
{
"name": "Cliente10",
"coordinates": {
"latitude": -23.761565,
"longitude": -46.655746
},
"logisticConstraints": "P1Delivery"
}
],
"depots": [
{
"name": "CD",
"coordinates": {
"latitude": -23.503939,
"longitude": -46.498419
},
"logisticConstraints": "P1Pickup"
}
],
"vehicleTypes": [
{
"name": "3/4",
"maxWeight": 15000,
"maxVolume": 30,
"size": 1
}
],
"vehicles": [
{
"name": "3/4_1",
"vehicleType": "3/4",
"legislationProfile": "DEFAULT",
"availablePeriods": [
{
"departureSite": "CD",
"arrivalSite": "CD",
"maxRoutesNumber": 1,
"timeWindow": {
"start": 1620298800000,
"end": 1620334800000
}
}
]
},
{
"name": "3/4_2",
"vehicleType": "3/4",
"legislationProfile": "DEFAULT",
"availablePeriods": [
{
"departureSite": "CD",
"arrivalSite": "CD",
"maxRoutesNumber": 1,
"timeWindow": {
"start": 1620298800000,
"end": 1620334800000
}
}
]
}
],
"operations": [
{
"id": "P1",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente1",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P2",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente2",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P3",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente3",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P4",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente4",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P5",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente4",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P6",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente6",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P7",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente7",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P8",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente8",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P9",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente9",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
},
{
"id": "P10",
"weight": 2,
"volume": 2,
"product": "DEFAULT",
"type": "DELIVERY",
"depotSite": "CD",
"customerSite": "Cliente10",
"customerTimeWindows": [
{
"start": 1620302400000,
"end": 1620309600000
}
]
}
],
"trip": {
"calculationMode": "THE_FASTEST",
"crossedBorders": {
"level": "CITY"
},
"toll": {
"vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES"
},
"freight": {
"operationType": [
"A",
"D"
],
"goodsType": [
"GRANEL_LIQUIDO",
"GRANEL_SOLIDO"
],
"axis": [
"2",
"4"
],
"roundTrip": false,
"backEmpty": false,
"otherCosts": [
{
"name": "ICMS",
"type": "PERCENT",
"value": "5"
},
{
"name": "Lucro",
"type": "PERCENT",
"value": "20"
},
{
"name": "TaxaFixa",
"type": "FIXED",
"value": "500"
}
],
"date": "2021-10-02"
}
}
}
Response
Na resposta da API, em cada rota irá constar o tripId, que poderá ser consultada através do endpoint https://api.maplink.global/trip/v1/solutions/{{tripjobid}}.
A resposta abaixo encontra-se truncada para facilitar a leitura.
{
"id": "62ff87d0c19aa95741dfff68",
"clientId": "maplink",
"vehicleRoutes": [
{
"routes": [
{
"id": "NewRoute_1_1",
"activities": [
{
"activity": "ROUTE_START",
"timeWindow": {
"start": 1620298800000,
"end": 1620298800000
},
"type": "SITE",
"site": "CD",
"operations": []
},
---- TRUNCADO
{
"activity": "ROUTE_END",
"timeWindow": {
"start": 1620311708000,
"end": 1620311708000
},
"type": "SITE",
"site": "CD",
"operations": []
}
],
"tripId": "62ff87d4c007780a2ed8f7cb"
}
],
"vehicle": "3/4_1",
"period": {
"timeWindow": {
"start": 1620298800000,
"end": 1620334800000
},
"departureSite": "CD",
"arrivalSite": "CD",
"maxRoutesNumber": 1
}
},
{
"routes": [
{
"id": "NewRoute_2_1",
"activities": [
{
"activity": "ROUTE_START",
"timeWindow": {
"start": 1620299268000,
"end": 1620299268000
},
"type": "SITE",
"site": "CD",
"operations": []
},
---- TRUNCADO
{
"activity": "ROUTE_END",
"timeWindow": {
"start": 1620308938000,
"end": 1620308938000
},
"type": "SITE",
"site": "CD",
"operations": []
}
],
"tripId": "62ff87d4eeeb972ff55c6f16"
}
],
"vehicle": "3/4_2",
"period": {
"timeWindow": {
"start": 1620298800000,
"end": 1620334800000
},
"departureSite": "CD",
"arrivalSite": "CD",
"maxRoutesNumber": 1
}
}
],
"indicators": {
"totalServiceTime": 6300,
"totalDeliveringTime": 2700,
"dayWorkingTotalTime": 22578,
"nightWorkingTotalTime": 0,
"totalUnloadingTime": 0,
"totalWorkingTime": 22578,
"totalCollectingTime": 0,
"timeWindowNumber": 2,
"totalDrivingTime": 16278,
"totalLoadingTime": 3600,
"totalTime": 22578,
"totalDistance": 191609,
"averageOccupancyRateVolume": 33.33,
"averageOccupancyRateWeight": 0.07,
"rejectOperationsNumber": 0,
"totalWaitingTime": 0,
"totalRestTime": 0,
"routesNumber": 2,
"tollCosts": 0
}
}
A resposta completa pode ser obtida no arquivo em anexo.
Solução do problema logístico
Os seguintes indicadores globais são retornados:
Indicador | Resultado |
Tempo total de serviço | 01:45:00 |
Tempo total de entrega | 00:45:00 |
Tempo total de trabalho diurno | 06:16:18 |
Tempo total de trabalho noturno | 00:00:00 |
Tempo total de descarregamento | 00:00:00 |
Tempo total de trabalho | 06:16:18 |
Tempo total de coleta | 00:00:00 |
Número de janelas de horário | 2 |
Tempo total de condução | 04:31:18 |
Tempo total de carregamento | 01:00:00 |
Tempo total | 06:16:18 |
Distância total | 191.61 km |
Taxa de ocupação média em Volume | 33.33 |
Taxa de ocupação média em Peso | 0.07 |
Número de rejeições | 0 |
Tempo total de espera | 00:00:00 |
Tempo total de descanso | 00:00:00 |
Número de rotas | 2 |
A resposta também retorna a sequência temporal de atividades de cada veículo. Esse é um exemplo do veículo de nome “3/4_1”:
VEÍCULO | ATIVIDADE | ID DO LOCAL DE PARTIDA | ID DO LOCAL DE RETORNO | DISTÂNCIA | DURAÇÃO NOMINAL | JANELA DE HORÁRIO INICIAL | JANELA DE HORÁRIO FINAL |
3/4_1 | ROUTE_START | CD | 06/05/21 08:00 | 06/05/21 08:00 | |||
3/4_1 | LOADING | CD | 06/05/21 08:00 | 06/05/21 08:30 | |||
3/4_1 | DRIVING | CD | Cliente2 | 37.96 km | 00:50:38 | 06/05/21 08:30 | 06/05/21 09:20 |
3/4_1 | DELIVERY | Cliente2 | 06/05/21 09:20 | 06/05/21 09:25 | |||
3/4_1 | DRIVING | Cliente2 | Cliente7 | 4.77 km | 00:07:27 | 06/05/21 09:25 | 06/05/21 09:33 |
3/4_1 | DELIVERY | Cliente7 | 06/05/21 09:33 | 06/05/21 09:38 | |||
3/4_1 | DRIVING | Cliente7 | Cliente10 | 26.91 km | 00:35:36 | 06/05/21 09:38 | 06/05/21 10:13 |
3/4_1 | DELIVERY | Cliente10 | 06/05/21 10:13 | 06/05/21 10:18 | |||
3/4_1 | DRIVING | Cliente10 | Cliente4 | 5.47 km | 00:10:25 | 06/05/21 10:18 | 06/05/21 10:29 |
3/4_1 | DELIVERY | Cliente4 | 06/05/21 10:29 | 06/05/21 10:34 | |||
3/4_1 | DRIVING | Cliente4 | CD | 45.25 km | 01:01:02 | 06/05/21 10:34 | 06/05/21 11:35 |
3/4_1 | ROUTE_END | CD | 06/05/21 11:35 | 06/05/21 11:35 |