{"id":1912,"date":"2023-12-14T20:17:33","date_gmt":"2023-12-14T20:17:33","guid":{"rendered":"https:\/\/developers.maplink.global\/lista-de-parametros-2\/"},"modified":"2025-08-14T14:13:08","modified_gmt":"2025-08-14T14:13:08","slug":"lista-de-parametros-trip","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/lista-de-parametros-trip\/","title":{"rendered":"Lista de par\u00e1metros"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\">Par\u00e1metros obligatorios<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>points<\/code> &#8211; Array de objetos, donde cada objeto representa una parada en la ruta con los siguientes campos:\n<ul class=\"wp-block-list\">\n<li><code>siteId<\/code> &#8211; Identificador del local.<\/li>\n\n\n\n<li><code>latitude<\/code>  &#8211; Coordenada de latitud en grados decimales.<\/li>\n\n\n\n<li><code>longitude<\/code>  &#8211; Coordenada de longitud en grados decimales.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>Ejemplo:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n\"points\": [\n        {\n            \"siteId\": \"Point 1-Extrema\",\n            \"latitude\": -22.859246,\n            \"longitude\": -46.339289\n        },\n        {\n            \"siteId\": \"Point 2-Betim\",\n            \"latitude\": -19.985117,\n            \"longitude\": -44.202667\n        }\n    ]\n}<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Par\u00e1metros opcionales<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>calculationMode<\/code>  &#8211; Indica el modo de c\u00e1lculo para el enrutamiento. Admite los siguientes tipos:\n<ul class=\"wp-block-list\">\n<li><code>THE_FASTEST<\/code>  &#8211; Consid\u00e9ralo la forma m\u00e1s r\u00e1pida. Valor por defecto.<\/li>\n\n\n\n<li><code>THE_SHORTEST<\/code>  &#8211; Considere la ruta con menor kilometraje.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>vehicleType<\/code>&nbsp;\u2013 Tipo de veh\u00edculo que se utilizar\u00e1 en la ruta. Se tendr\u00e1n en cuenta <strong>el peso, la altura y las caracter\u00edsticas espec\u00edficas del veh\u00edculo para devolverlo por la ruta adecuada<\/strong>. El valor predeterminado, si no se proporciona el par\u00e1metro, es <code>TRUCK_WITH_TWO_DOUBLE_AXLES<\/code>. Los valores posibles son:\n<ul class=\"wp-block-list\">\n<li><code>MOTORCYCLE<\/code><\/li>\n\n\n\n<li><code>CAR<\/code><\/li>\n\n\n\n<li><code>CAR_WITH_THREE_SIMPLE_AXLES<\/code><\/li>\n\n\n\n<li><code>CAR_WITH_FOUR_SIMPLE_AXLES<\/code><\/li>\n\n\n\n<li><code>BUS_WITH_TWO_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>BUS_WITH_THREE_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>BUS_WITH_FOUR_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>BUS_WITH_FIVE_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_NINE_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_TWO_SINGLE_AXIS<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_TWO_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_THREE_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_FOUR_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_FIVE_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_SIX_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_SEVEN_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_EIGHT_DOUBLE_AXLES<\/code><\/li>\n\n\n\n<li><code>TRUCK_WITH_TEN_DOUBLE_AXLES<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>avoidanceTypes<\/code>  &#8211; Indica que la ruta tendr\u00e1 que desviarse de ciertos tipos de elementos del sistema de carreteras. Los valores permitidos son:\n<ul class=\"wp-block-list\">\n<li><code>TUNNELS<\/code>  &#8211; La ruta evitar\u00e1 los t\u00faneles;<\/li>\n\n\n\n<li><code>BRIDGES<\/code>  &#8211; La ruta evitar\u00e1 los puentes;<\/li>\n\n\n\n<li><code>FERRIES<\/code>  &#8211; La ruta evitar\u00e1 los transbordadores.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>avoidanceBehavior<\/code>&nbsp;\u2013 Indica como o planejador de rotas deve se comportar se a rota tiver elementos del sistema de carreteras que devem ser evitadas declaradas em <code>avoidanceTypes<\/code>. Os valores permitidos s\u00e3o:\n<ul class=\"wp-block-list\">\n<li><code>FAIL<\/code>&nbsp;\u2013 Comportamiento por defecto de la API si no se proporciona el par\u00e1metro. Si no es posible completar una ruta sin pasar por un elemento a evitar, se devolver\u00e1 un mensaje de error. Por ejemplo, se devolver\u00e1 un mensaje de error al utilizar&nbsp;<code>\"avoidanceTypes\":[\"FERRIES\"]<\/code> en una ruta en la que solo se puede llegar a uno de los puntos en ferry;<\/li>\n\n\n\n<li><code>STRONG<\/code>&nbsp;\u2013 Se evitar\u00e1n los elementos, pero si no es posible completar la ruta sin pasar por alguno de los elementos, igualmente se devolver\u00e1 la ruta. Por ejemplo, una ruta en que uno de los puntos solo se puede acceder a en ferry, se devolver\u00e1 la ruta incluso utilizando&nbsp;<code>\"avoidanceTypes\":[\"FERRIES\"]<\/code>;<\/li>\n\n\n\n<li><code>RELAXED<\/code>&nbsp;\u2013 No se evitar\u00e1n completamente los elementos de carreteras, pero se priorizar\u00e1 la ruta con menor cantidad de estos elementos.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>toll<\/code> &#8211; Indica que la ruta debe informar del c\u00e1lculo del peaje. Deben introducirse los siguientes par\u00e1metros:\n<ul class=\"wp-block-list\">\n<li><code>vehicleType<\/code>  &#8211; Texto que define el tipo de veh\u00edculo que se tendr\u00e1 en cuenta para calcular el peaje. Los valores posibles son:  <span style=\"color: initial;\"> <\/span><ul><li><code>MOTORCYCLE<\/code> <\/li><li><code>CAR<\/code>   <\/li><li><code>CAR_WITH_THREE_SIMPLE_AXLES<\/code>   <\/li><li><code>CAR_WITH_FOUR_SIMPLE_AXLES<\/code>   <\/li><li><code>BUS_WITH_TWO_DOUBLE_AXLES<\/code>   <\/li><li><code>BUS_WITH_THREE_DOUBLE_AXLES<\/code>   <\/li><li><code>BUS_WITH_FOUR_DOUBLE_AXLES<\/code>   <\/li><li><code>BUS_WITH_FIVE_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_NINE_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_TWO_SINGLE_AXIS<\/code>   <\/li><li><code>TRUCK_WITH_TWO_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_THREE_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_FOUR_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_FIVE_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_SIX_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_SEVEN_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_EIGHT_DOUBLE_AXLES<\/code>   <\/li><li><code>TRUCK_WITH_TEN_DOUBLE_AXLES<\/code><\/li> <\/ul><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>crossedBorders<\/code> &#8211; Solo para rutas en Brasil. Indica que tambi\u00e9n debe devolverse alguna informaci\u00f3n sobre la ruta:\n<ul class=\"wp-block-list\">\n<li><code>level<\/code>  &#8211; Devolver\u00e1 las ciudades o estados que atraviesa la ruta. Valores posibles:\n<ul class=\"wp-block-list\">\n<li><code>CITY<\/code><strong> <\/strong>&#8211; Devuelve a las ciudades atravesadas por la ruta.<\/li>\n\n\n\n<li><code>STATE<\/code>  &#8211; Devuelve los estados atravesados por la ruta.<\/li>\n\n\n\n<li><code>NONE<\/code>  &#8211; El par\u00e1metro no se utilizar\u00e1.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>reverseGeocode<\/code> &#8211; La <a href=\"https:\/\/developers.maplink.global\/es\/reverse-geocode-api\/\" data-type=\"post\" data-id=\"1241\">Reverse Geocode API<\/a> se utilizar\u00e1 para devolver m\u00e1s informaci\u00f3n sobre puntos importantes de la ruta. Valores posibles:\n<ul class=\"wp-block-list\">\n<li><code>START_END<\/code>  &#8211; Se devolver\u00e1n los campos <code>startAddress<\/code> y <code>endAddress<\/code> con informaci\u00f3n sobre el primer y el \u00faltimo punto de la ruta.<\/li>\n\n\n\n<li><code>START_END_LEGS<\/code> &#8211; El campo <code>firstPointAddress<\/code> se devolver\u00e1 dentro de cada <em>leg<\/em> (tramo de la ruta), con informaci\u00f3n sobre el punto de partida del <em>leg<\/em>en cuesti\u00f3n.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>callback<\/code> &#8211; S\u00f3lo disponible en Trip Asincr\u00f3nica. Contiene los datos de <em>callback<\/em>, que es una URL de <em>webhook <\/em>para recibir los eventos de c\u00e1lculo de problemas. Los posibles argumentos son:\n<ul class=\"wp-block-list\">\n<li><code>url<\/code> &#8211; URL con la direcci\u00f3n que recibir\u00e1 lo <em>callback<\/em>.<\/li>\n\n\n\n<li><code>user<\/code>  &#8211; Texto con el nombre del usuario si el <em>webhook <\/em>requiere autenticaci\u00f3n<em>.<\/em><\/li>\n\n\n\n<li><code>password<\/code>  &#8211; Texto con la contrase\u00f1a en caso de que el endpoint necesite autenticaci\u00f3n.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>restrictionZones<\/code> &#8211; Array con el texto del nombre de la zona de restricci\u00f3n registrada previamente en la <a href=\"https:\/\/developers.maplink.global\/es\/creacion-de-solicitudes-para-la-restriction-zone-api\/\" data-type=\"post\" data-id=\"1321\">Restriction Zone API<\/a><\/li>\n\n\n\n<li><code>place<\/code>  &#8211; Se utiliza para devolver puntos de inter\u00e9s (POI) en la ruta. Deben introducirse los siguientes par\u00e1metros:\n<ul class=\"wp-block-list\">\n<li><code>bufferRouteInMeters<\/code>  &#8211; Entero con el radio de b\u00fasqueda de puntos de inter\u00e9s a lo largo de la ruta. L\u00edmite de 500 metros.<\/li>\n\n\n\n<li><code>bufferStoppingPointsInMeters<\/code>  &#8211; Entero con el radio de b\u00fasqueda de puntos de inter\u00e9s en las paradas. L\u00edmite de 500 metros.<\/li>\n\n\n\n<li><code>onlyMyPlaces<\/code> &#8211; Valor booleano que indica si s\u00f3lo se devolver\u00e1n los establecimientos de su propia base o si tambi\u00e9n se utilizar\u00e1 la base nativa del servicio. Para m\u00e1s informaci\u00f3n, consulte la documentaci\u00f3n de la <a href=\"https:\/\/developers.maplink.global\/es\/creacion-de-solicitudes-para-la-pois-api\/\" data-type=\"post\" data-id=\"1297\">POIs API<\/a>.<\/li>\n\n\n\n<li><code>categories<\/code> &#8211; Array con las categor\u00edas de los establecimientos deseados.<\/li>\n\n\n\n<li><code>subCategories<\/code> &#8211; (Opcional) Array con las subcategor\u00edas de los establecimientos deseados.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>turnByTurn<\/code>&nbsp;\u2013 Objeto donde se especificar\u00e1n las preferencias relacionadas con el&nbsp;<a href=\"https:\/\/developers.maplink.global\/exemplo-6-obter-rotograma-detalhado-da-rota\/\">rotograma<\/a>:\n<ul class=\"wp-block-list\">\n<li><code>language<\/code>&nbsp;\u2013 String que representa el idioma en el que se deben devolver las instrucciones, siguiendo la convenci\u00f3n&nbsp;<strong>pt_BR, es_EN, es_AR, en<\/strong>, etc.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>A continuaci\u00f3n se muestra un ejemplo con todos los par\u00e1metros opcionales:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n     \"calculationMode\": \"THE_FASTEST\",\n     \"vehicleType\": \"CAR\",\n     \"points\": [\n        {\n            \"siteId\": \"Point 1-Extrema\",\n            \"latitude\": -22.859246,\n            \"longitude\": -46.339289\n        },\n        {\n            \"siteId\": \"Point 2-Betim\",\n            \"latitude\": -19.985117,\n            \"longitude\": -44.202667\n        }\n    ],\n    \"avoidanceTypes\":[\"FERRIES\"],\n    \"avoidanceBehavior\": \"STRONG\",    \n    \"toll\": {\n        \"vehicleType\": \"CAR\"\n    },\n    \"place\": {\n        \"categories\": [\n            \"ALIMENTOS_E_BEBIDAS\",\n            \"ACADEMIAS\"\n        ],\n        \"bufferRouteInMeters\": 500,\n        \"bufferStoppingPointsInMeters\": 500,\n        \"onlyMyPlaces\": true\n    },\n    \"crossedBorders\": {\n        \"level\": \"CITY\",\n        \"reverseGeocode\": \"START_END_LEGS\"\n    },\n    \"restrictionZones\": [\n        \"MG_BR381_530_km_AltCentl_5_75\",\n        \"MG_BR381_620_km_AltCentl_5_61\"\n    ],\n    \"turnByTurn\":{\n        \"language\":\"es_AR\"\n    }\n }<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Par\u00e1metros obligatorios Ejemplo: Par\u00e1metros opcionales A continuaci\u00f3n se muestra un ejemplo con todos los par\u00e1metros opcionales:<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[148],"tags":[],"class_list":["post-1912","post","type-post","status-publish","format-standard","hentry","category-trip-es"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/1912","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/comments?post=1912"}],"version-history":[{"count":17,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/1912\/revisions"}],"predecessor-version":[{"id":3536,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/1912\/revisions\/3536"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=1912"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=1912"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=1912"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}