points<\/code>) y del modo de c\u00e1lculo (calculationMode<\/code>), usaremos los siguientes par\u00e1metros:<\/p>\n\n\n\n\navoidanceTypes<\/code> \u2013 Tipos de v\u00eda o \u00e1rea que deben evitarse en la ruta. Informaremos CITY<\/code> para evitar \u00e1reas urbanas;<\/li>\n\n\n\navoidanceBehavior<\/code> \u2013 Comportamiento aplicado a las restricciones de avoidanceTypes<\/code>. Los valores posibles son FAIL<\/code>, RELAXED<\/code> y STRONG<\/code>. Usaremos STRONG<\/code>;<\/li>\n\n\n\ntoll<\/code> \u2013 Par\u00e1metros referentes a la Toll API. Para conocer todos los par\u00e1metros soportados, consulte la lista de par\u00e1metros<\/a>:\n\nvehicleType<\/code> \u2013 Tipo de veh\u00edculo. Usaremos \"TRUCK_WITH_TWO_DOUBLE_AXLES\"<\/code>;<\/li>\n\n\n\ntransponderOperators<\/code> \u2013 Operadoras de pago autom\u00e1tico deseadas. Informaremos CONECTCAR<\/code> para obtener los c\u00f3digos de integraci\u00f3n de esa operadora.<\/li>\n<\/ul>\n<\/li>\n\n\n\ncrossedBorders<\/code> \u2013 Par\u00e1metros para identificar las fronteras cruzadas por la ruta:\n\nlevel<\/code> \u2013 Nivel de las fronteras devueltas. Usaremos STATE<\/code> para obtener los estados recorridos;<\/li>\n\n\n\nreverseGeocode<\/code> \u2013 Define para qu\u00e9 puntos se devolver\u00e1 la direcci\u00f3n. Usaremos START_END_LEGS<\/code> para obtener las direcciones del inicio y del fin de los tramos.<\/li>\n<\/ul>\n<\/li>\n\n\n\nplace<\/code> \u2013 Par\u00e1metros para buscar lugares a lo largo de la ruta. Para conocer todos los par\u00e1metros soportados, consulte la lista de par\u00e1metros de la POIs API<\/a>:\n\ncategories<\/code> \u2013 Categor\u00edas de los lugares buscados. Usaremos POSTOS_DE_COMBUSTIVEL<\/code>;<\/li>\n\n\n\nsubCategories<\/code> \u2013 Subcategor\u00edas de los lugares buscados, por ejemplo POSTO_FISCAL<\/code> y BALANCAS<\/code>, de la categor\u00eda FISCALIZACAO<\/code>. Par\u00e1metro opcional, no utilizado en este ejemplo;<\/li>\n\n\n\nbufferRouteInMeters<\/code> \u2013 Distancia m\u00e1xima, en metros, entre el lugar y la ruta. Usaremos 500<\/code>;<\/li>\n\n\n\nbufferStoppingPointsInMeters<\/code> \u2013 Distancia m\u00e1xima, en metros, entre el lugar y los puntos de parada. Usaremos 500<\/code>;<\/li>\n\n\n\nonlyMyPlaces<\/code> \u2013 Cuando es true<\/code>, devuelve solo los lugares registrados por el propio cliente.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n{\n \"points\": [\n {\n \"siteId\": \"Point 1-Casa Branca\",\n \"latitude\": -21.780449,\n \"longitude\": -47.079822\n },\n {\n \"siteId\": \"Point 2-Guaxupe\",\n \"latitude\": -21.312320,\n \"longitude\": -46.717873\n }\n ],\n \"calculationMode\": \"THE_FASTEST\",\n \"avoidanceTypes\": [\n \"CITY\"\n ],\n \"avoidanceBehavior\": \"STRONG\",\n \"toll\": {\n \"vehicleType\": \"TRUCK_WITH_TWO_DOUBLE_AXLES\",\n \"transponderOperators\": [\n \"CONECTCAR\"\n ]\n },\n \"crossedBorders\": {\n \"level\": \"STATE\",\n \"reverseGeocode\": \"START_END_LEGS\"\n },\n \"place\": {\n \"categories\": [\n \"POSTOS_DE_COMBUSTIVEL\"\n ],\n \"bufferRouteInMeters\": 500,\n \"bufferStoppingPointsInMeters\": 500,\n \"onlyMyPlaces\": true\n }\n}<\/pre>\n\n\n\nA continuaci\u00f3n, la ruta visualizada en el mapa:<\/p>\n\n\n\n![\"\"](\"https:\/\/developers.maplink.global\/wp-content\/uploads\/2026\/11\/image.png\")
Ruta entre Casa Branca – SP y Guaxup\u00e9 – MG<\/figcaption><\/figure>\n\n\n\nRespuesta<\/h2>\n\n\n\n
Algunos campos de la respuesta se devuelven siempre, mientras que otros solo aparecen cuando el par\u00e1metro correspondiente se informa en la solicitud. Por ejemplo, los campos de peaje solo se devuelven si se informa el objeto toll<\/code>.<\/p>\n\n\n\nCampos devueltos siempre<\/h3>\n\n\n\n\nid<\/code> \u2013 Identificador \u00fanico de la ruta calculada;<\/li>\n\n\n\nclientId<\/code> \u2013 Identificador del cliente que realiz\u00f3 la solicitud;<\/li>\n\n\n\ntotalDistance<\/code> \u2013 Distancia total de la ruta, en metros;<\/li>\n\n\n\ntotalNominalDuration<\/code> \u2013 Duraci\u00f3n nominal total de la ruta, en segundos;<\/li>\n\n\n\naverageSpeed<\/code> \u2013 Velocidad media de la ruta, en km\/h;<\/li>\n\n\n\nlegs<\/code> \u2013 Array de objetos donde cada objeto representa un tramo de la ruta. Cada objeto contiene los siguientes campos, siempre devueltos:\n\ndistance<\/code> \u2013 Distancia del tramo, en metros;<\/li>\n\n\n\nnominalDuration<\/code> \u2013 Duraci\u00f3n nominal del tramo, en segundos;<\/li>\n\n\n\naverageSpeed<\/code> \u2013 Velocidad media del tramo, en km\/h;<\/li>\n\n\n\npoints<\/code> \u2013 Geometr\u00eda del tramo. El formato depende del par\u00e1metro pointsMode<\/code> de la solicitud. Para saber m\u00e1s, consulte c\u00f3mo cambiar el tipo de retorno de las coordenadas de la ruta<\/a>.<\/li>\n<\/ul>\n<\/li>\n\n\n\nsource<\/code> \u2013 Origen del mapa utilizado en el c\u00e1lculo de la ruta. Siempre se devolver\u00e1 como MAPLINK<\/code>.<\/li>\n\n\n\ncreatedAt<\/code> \u2013 Fecha y hora de creaci\u00f3n de la ruta, en formato timestamp<\/em>;<\/li>\n\n\n\nexpiryIn<\/code> \u2013 Fecha y hora de expiraci\u00f3n de la ruta, en formato timestamp<\/em>.<\/li>\n<\/ul>\n\n\n\nCampos devueltos solo si se informa el objeto toll<\/code><\/h3>\n\n\n\n\ntollCosts<\/code> \u2013 Valor total de los peajes en toda la ruta;<\/li>\n\n\n\nlegs[].tollCalculation<\/code> \u2013 Objeto, devuelto en cada tramo, con los valores e informaci\u00f3n de peaje del tramo correspondiente:\n\ntolls<\/code> \u2013 Array con los valores e informaci\u00f3n de cada peaje en el tramo. Cada objeto devuelto en tolls<\/code> representa un peaje y contendr\u00e1 la siguiente informaci\u00f3n:\n\nid<\/code> \u2013 Identificador \u00fanico del peaje;<\/li>\n\n\n\ntype<\/code> \u2013 Tipo de peaje. Los valores posibles son:\n\nTOLL_BOOTH<\/code> \u2013 Casetas de peaje convencionales;<\/li>\n\n\n\nMUNICIPAL_TOLL_BOOTH<\/code> \u2013 <\/strong>Similar a TOLL_BOOTH<\/code>, sirve \u00fanicamente para identificar que la caseta de peaje es municipal;<\/li>\n\n\n\nTOLL_GANTRY<\/code> \u2013 Corresponde a los p\u00f3rticos convencionales;<\/li>\n\n\n\nENTRY_GANTRY<\/code> \u2013 Corresponde a los p\u00f3rticos de entrada, utilizados en carreteras con cobro por tramos<\/a>;<\/li>\n\n\n\nEXIT_GANTRY<\/code> \u2013 Corresponde a los p\u00f3rticos de salida, utilizados en carreteras con cobro por tramos<\/a>.<\/li>\n<\/ul>\n<\/li>\n\n\n\nname<\/code> \u2013 Nombre del peaje;<\/li>\n\n\n\naddress<\/code> \u2013 Direcci\u00f3n del peaje;<\/li>\n\n\n\ncity<\/code> \u2013 Ciudad del peaje;<\/li>\n\n\n\nstate<\/code> \u2013 Objeto que contiene el nombre del estado (name<\/code>) y su sigla (code<\/code>);<\/li>\n\n\n\ncountry<\/code> \u2013 Pa\u00eds del peaje;<\/li>\n\n\n\nconcession<\/code> \u2013 Concesionaria responsable del peaje;<\/li>\n\n\n\ndirection<\/code> \u2013 Sentido de la v\u00eda en que se cobra el peaje (por ejemplo, NORTH<\/code>, EAST<\/code> o SOUTHEAST<\/code>);<\/li>\n\n\n\ncoordinates<\/code> \u2013 Coordenadas (latitud y longitud) del peaje;<\/li>\n\n\n\nprice<\/code> \u2013 Valor por peaje;<\/li>\n\n\n\nconditions<\/code> \u2013 Array con valores diferenciados del peaje seg\u00fan el tipo de cobro. Se devuelve solo en los peajes que tienen este tipo de valor:\n\nbillingsType<\/code> \u2013 Array con los tipos de cobro a los que se aplica el valor, por ejemplo TAG<\/code>;<\/li>\n\n\n\nvalue<\/code> \u2013 Valor del peaje para los tipos de cobro informados.<\/li>\n<\/ul>\n<\/li>\n\n\n\ncurrency<\/code> \u2013 Tipo de moneda utilizada por el peaje. Los valores posibles son:\n\nBRL<\/code> \u2013 Real brasile\u00f1o;<\/li>\n\n\n\nARS<\/code> \u2013 Peso argentino;<\/li>\n\n\n\nCLP<\/code> \u2013 Peso chileno;<\/li>\n\n\n\nCOP<\/code> \u2013 Peso colombiano;<\/li>\n\n\n\nMXN<\/code> \u2013 Peso mexicano.<\/li>\n<\/ul>\n<\/li>\n\n\n\nserviceTypes<\/code> \u2013 Array con c\u00f3digos para integraci\u00f3n con sistemas de pago autom\u00e1tico. Actualmente disponible solo en Brasil. Adem\u00e1s de ANTTCODE<\/code>, se devuelven los c\u00f3digos de las operadoras informadas en toll.transponderOperators<\/code> (en este ejemplo, CONECTCAR<\/code>);\n\nserviceId<\/code> \u2013 C\u00f3digo para la integraci\u00f3n;<\/li>\n\n\n\nname<\/code> \u2013 Descripci\u00f3n del c\u00f3digo del servicio.<\/li>\n<\/ul>\n<\/li>\n\n\n\nactive<\/code> \u2013 Indica si el peaje est\u00e1 activo (true<\/code>) o no (false<\/code>).<\/li>\n<\/ul>\n<\/li>\n\n\n\nlegTotalCost<\/code> \u2013 Valor total de peajes para el tramo;<\/li>\n\n\n\nvehicleType<\/code> \u2013 Tipo de veh\u00edculo considerado para el tramo. Puede variar entre los tramos cuando se informa toll.variableAxles<\/code>;<\/li>\n\n\n\ncalculationDate<\/code> \u2013 Fecha y hora considerados para el tramo, en formato timestamp<\/em>. La fecha base es el valor de toll.calculationDate<\/code> (o el momento de la solicitud, si no se informa), sumada a la duraci\u00f3n nominal de los tramos anteriores. Por eso, en rutas con m\u00e1s de un tramo, el valor aumenta en cada tramo;<\/li>\n\n\n\ncondition<\/code> \u2013 Se devuelve solo si se usa el par\u00e1metro toll.condition<\/code> en la solicitud. Contiene qu\u00e9 billingType<\/code> y period<\/code> se consideraron para el tramo.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\nCampos devueltos solo si se informa crossedBorders.level<\/code><\/h3>\n\n\n\n\ncrossedBorders<\/code> \u2013 Array de objetos donde cada objeto representa una frontera cruzada por la ruta, de acuerdo con el nivel informado en crossedBorders.level<\/code> (en este ejemplo, STATE<\/code>), en el orden en que fueron recorridas:\n\nstate<\/code> \u2013 Sigla del estado;<\/li>\n\n\n\ncity<\/code> \u2013 Nombre de la ciudad. Se devuelve cuando level<\/code> es CITY<\/code>;<\/li>\n\n\n\ncountry<\/code> \u2013 Pa\u00eds de la frontera.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\nCampos devueltos solo si se informa crossedBorders.reverseGeocode<\/code><\/h3>\n\n\n\nEstos campos son independientes de crossedBorders.level<\/code>. Con START_END<\/code>, se devuelven startAddress<\/code> y endAddress<\/code>. Con START_END_LEGS<\/code>, tambi\u00e9n se devuelve legs[].firstPointAddress<\/code>.<\/p>\n\n\n\n\nstartAddress<\/code> \u2013 Direcci\u00f3n del punto de origen de la ruta. El objeto contiene la siguiente informaci\u00f3n:\n\nroad<\/code> \u2013 Calle;<\/li>\n\n\n\ndistrict<\/code> \u2013 Barrio;<\/li>\n\n\n\nzipCode<\/code> \u2013 C\u00f3digo postal;<\/li>\n\n\n\ncity<\/code> \u2013 Ciudad;<\/li>\n\n\n\nstate<\/code> \u2013 Objeto que contiene el nombre del estado (name<\/code>) y su sigla (code<\/code>);<\/li>\n\n\n\nmainLocation<\/code> \u2013 Coordenadas (lat<\/code> y lon<\/code>) de la direcci\u00f3n encontrada;<\/li>\n\n\n\n- Cuando est\u00e1n disponibles para la direcci\u00f3n, tambi\u00e9n pueden devolverse
geometry<\/code> (array de coordenadas lat<\/code> y lon<\/code> de la v\u00eda), leftZipCode<\/code> y rightZipCode<\/code> (c\u00f3digo postal de cada lado de la v\u00eda), leftFirstNumber<\/code>, leftLastNumber<\/code>, rightFirstNumber<\/code> y rightLastNumber<\/code> (numeraci\u00f3n inicial y final de cada lado de la v\u00eda).<\/li>\n<\/ul>\n<\/li>\n\n\n\nendAddress<\/code> \u2013 Direcci\u00f3n del punto de destino de la ruta, con la misma estructura del objeto