--- title: Exemplo 1 - Operações com um único veículo description: Exemplo de utilização da Planning API com um problema logístico simples com um único veículo. --- [Pular para o conteúdo](https://knowledge.maplink.global/migration/pt-br/base/exemplo-planning-operacoes-com-um-unico-veículo#main-content) Português - Brasil Mostrar submenu para traduções [Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new?hsLang=pt-br) [Portal do cliente](https://knowledge.maplink.global/customers?hsLang=pt-br) ![logo\_maplink-1.png\]](https://knowledge.maplink.global/hs-fs/hubfs/logo_maplink-1.png?height=40&name=logo_maplink-1.png) Abrir navegação principal Fechar navegação principal - Português - Brasil Mostrar submenu para traduções - [Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new) - [Portal do cliente](https://knowledge.maplink.global/customers) - Ir para maplink.global Ir para maplink.global Olá. Como podemos ajudá-lo? - Não há sugestões porque o campo de pesquisa está em branco. 1. [Centro de ajuda](https://knowledge.maplink.global/migration/pt-br/base?hsLang=pt-br) 2. [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br) 3. [Planning API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#planning-api) # Exemplo 1 - Operações com um único veículo ## Exemplo de utilização da Planning API com um problema logístico simples com um único veículo. Neste exemplo, temos uma requisição para Planning API resolver um problema logístico de 1 veículo e 2 operações, partindo do centro de distribuição. ![735e7ed2-065d-4931-a572-4b3bac2e6c25](https://knowledge.maplink.global/hs-fs/hubfs/735e7ed2-065d-4931-a572-4b3bac2e6c25.png?width=688&height=312&name=735e7ed2-065d-4931-a572-4b3bac2e6c25.png) #### Parâmetros utilizados **"optimizationProfile": "BRAZIL46"**. Para essa simulação, foi usado o perfil de otimização BRAZIL46, o mais indicado para problemas mais simples. **"tripsProfile": "MAPLINK"**. 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": 1671516600000**. Horário de início de referência para o cálculo da otimização logística (Terça-feira, 20 de dezembro de 2022 06:10:00). **"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 900 segundos (15 minutos) para o tempo de carregamento do caminhão e 600 segundos (10 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 em 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. Neste exemplo, um veículo do tipo VUC. Se define também o período de trabalho e o perfil de legislação aplicável ao motorista. Foi definido que o veículo irá sair e retornar para o 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. Neste exemplo, são 2 operações.   #### Requisição ``` {    "optimizationProfile": "BRAZIL46",    "tripsProfile": "MAPLINK",    "startDate": 1671516600000,    "legislationProfiles": [        {            "name": "DEFAULT"        }    ],    "logisticConstraints": [        {            "name": "P1Pickup",            "siteLoadingFixedTime": 900        },        {            "name": "P1Delivery",            "siteUnloadingFixedTime": 600        }    ],    "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"        }    ],    "depots": [        {            "name": "CD",            "coordinates": {                "latitude": -23.503939,                "longitude": -46.498419            },            "logisticConstraints": "P1Pickup"        }    ],    "vehicleTypes": [        {            "name": "VUC",            "maxVolume": 20,            "maxWeight": 1200,            "size": 1        }    ],    "vehicles": [        {            "name": "VUC_1",            "vehicleType": "VUC",            "legislationProfile": "DEFAULT",            "availablePeriods": [                {                    "departureSite": "CD",                    "arrivalSite": "CD",                    "timeWindow": {                        "start": 1671519600000,                        "end": 1671562800000                    }                }            ]        }    ],    "operations": [        {            "id": "P1",            "weight": 100,            "volume": 2,            "product": "DEFAULT",            "type": "DELIVERY",            "depotSite": "CD",            "customerSite": "Cliente1",            "customerTimeWindows": [                {                    "start": 1671523200000,                    "end": 1671537600000                }            ]        },        {            "id": "P2",            "weight": 250,            "volume": 5,            "product": "DEFAULT",            "type": "DELIVERY",            "depotSite": "CD",            "customerSite": "Cliente2",            "customerTimeWindows": [                {                    "start": 1671523200000,                    "end": 1671537600000                }            ]        }    ]} ``` #### Solução do problema logístico A resposta da API retornará no formato JSON com o melhor sequenciamento das operações de entrega para cada veículo. ![solution-planning](https://knowledge.maplink.global/hs-fs/hubfs/solution-planning.png?width=688&height=401&name=solution-planning.png) A resposta retorna os seguintes indicadores globais:   | **Indicador** | **Resultado** | | --- | --- | | **Tempo total de serviço:** | 00:35:00 | | **Tempo total de entrega:** | 00:20:00 | | **Tempo total do dia de trabalho:** | 02:24:07 | | **Tempo total de trabalho noturno:** | 00:00:00 | | **Tempo total de descarregamento:** | 00:00:00 | | **Tempo total de trabalho:** | 02:24:07 | | **Tempo total de coleta:** | 00:00:00 | | **Número de janelas de horário:** | 1 | | **Tempo total de condução:** | 01:49:07 | | **Tempo total de carregamento:** | 00:15:00 | | **Tempo total:** | 02:24:07 | | **Distância total:** | 75.03 km | | **Taxa de ocupação média em Volume:** | 35 | | **Taxa de ocupação média em Peso:** | 29.17 | | **Número de rejeições:** | 0 | | **Tempo total de espera:** | 00:00:00 | | **Tempo total de descanso:** | 00:00:00 | | **Número de rotas:** | 1 |   Abaixo a reposta completa. Repare que a rota apresentará a sequência temporal das atividades realizada pelo veículo: ``` {    "id": "62a3425f368c8a6c62d9397a",    "clientId": "915xlwDleOGUKQEAOPnvO6nz1ql9ucuz",    "vehicleRoutes": [        {            "routes": [                {                    "id": "NewRoute_1_1",                    "activities": [                        {                            "activity": "ROUTE_START",                            "timeWindow": {                                "start": 1671520968000,                                "end": 1671520968000                            },                            "type": "SITE",                            "site": "CD",                            "operations": []                        },                        {                            "activity": "LOADING",                            "timeWindow": {                                "start": 1671520968000,                                "end": 1671521868000                            },                            "type": "SITE",                            "site": "CD",                            "fixedTimeSite": 900,                            "operations": [                                "P2",                                "P1"                            ]                        },                        {                            "activity": "DRIVING",                            "timeWindow": {                                "start": 1671521868000,                                "end": 1671523200000                            },                            "type": "DRIVING",                            "operations": [],                            "arrivalSite": "Cliente1",                            "departureSite": "CD",                            "distance": 13411,                            "nominalDuration": 1332                        },                        {                            "activity": "DELIVERY",                            "timeWindow": {                                "start": 1671523200000,                                "end": 1671523800000                            },                            "type": "SITE",                            "site": "Cliente1",                            "fixedTimeSite": 600,                            "operations": [                                "P1"                            ]                        },                        {                            "activity": "DRIVING",                            "timeWindow": {                                "start": 1671523800000,                                "end": 1671526134000                            },                            "type": "DRIVING",                            "operations": [],                            "arrivalSite": "Cliente2",                            "departureSite": "Cliente1",                            "distance": 26969,                            "nominalDuration": 2334                        },                        {                            "activity": "DELIVERY",                            "timeWindow": {                                "start": 1671526134000,                                "end": 1671526734000                            },                            "type": "SITE",                            "site": "Cliente2",                            "fixedTimeSite": 600,                            "operations": [                                "P2"                            ]                        },                        {                            "activity": "DRIVING",                            "timeWindow": {                                "start": 1671526734000,                                "end": 1671529615000                            },                            "type": "DRIVING",                            "operations": [],                            "arrivalSite": "CD",                            "departureSite": "Cliente2",                            "distance": 34647,                            "nominalDuration": 2881                        },                        {                            "activity": "ROUTE_END",                            "timeWindow": {                                "start": 1671529615000,                                "end": 1671529615000                            },                            "type": "SITE",                            "site": "CD",                            "operations": []                        }                    ]                }            ],            "vehicle": "VUC_1",            "period": {                "timeWindow": {                    "start": 1671519600000,                    "end": 1671562800000                },                "departureSite": "CD",                "arrivalSite": "CD"            }        }    ],    "indicators": {        "totalServiceTime": 2100,        "totalDeliveringTime": 1200,        "dayWorkingTotalTime": 8647,        "nightWorkingTotalTime": 0,        "totalUnloadingTime": 0,        "totalWorkingTime": 8647,        "totalCollectingTime": 0,        "timeWindowNumber": 1,        "totalDrivingTime": 6547,        "totalLoadingTime": 900,        "totalTime": 8647,        "totalDistance": 75027,        "averageOccupancyRateVolume": 35.0,        "averageOccupancyRateWeight": 29.17,        "rejectOperationsNumber": 0,        "totalWaitingTime": 0,        "totalRestTime": 0,        "routesNumber": 1    }} ```   - [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#main-content) - [Planning API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#planning-api) - [Trip API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#trip-api) - [Toll API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-api) - [Toll for Maps API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-for-maps-api) - [Distance Matrix API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#distance-matrix-api) - [CO2 API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#co2-api) - [Restriction Zone API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#restriction-zone-api) - [Geocode API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#geocode-api) - [Freight API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#freight-api) - [Tracking API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#tracking-api) - [APIs Google Maps Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-google-maps-platform?hsLang=pt-br) - [Webinar e Workshop](https://knowledge.maplink.global/migration/pt-br/base/webinar-e-workshop?hsLang=pt-br) [![](https://knowledge.maplink.global/hs-fs/hubfs/logo-maplink-novo-horizontal-colorido%20PNG.png?width=2190&height=540&name=logo-maplink-novo-horizontal-colorido%20PNG.png)](http://maplink.global) Centro de ajuda maplink.global Copyright © 2026, Maplink Cloud