{"id":2545,"date":"2023-12-14T20:17:33","date_gmt":"2023-12-14T20:17:33","guid":{"rendered":"https:\/\/developers.maplink.global\/list-of-parameters\/"},"modified":"2025-08-14T14:13:58","modified_gmt":"2025-08-14T14:13:58","slug":"list-of-parameters-trip","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/en\/list-of-parameters-trip\/","title":{"rendered":"List of parameters"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\">Mandatory parameters<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>points<\/code>  &#8211; Array of objects, where each object represents a stop on the route with the following fields:\n<ul class=\"wp-block-list\">\n<li><code>siteId<\/code>  &#8211; Stop point identifier.<\/li>\n\n\n\n<li><code>latitude<\/code>  &#8211; Latitude coordinate in decimal degrees.<\/li>\n\n\n\n<li><code>longitude<\/code>  &#8211; Longitude coordinate in decimal degrees.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>Example:<\/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>Optional parameters<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>calculationMode<\/code>  &#8211; Indicates the calculation mode for routing. Supports types:\n<ul class=\"wp-block-list\">\n<li><code>THE_FASTEST<\/code>  &#8211; Consider it the fastest way. Default value.<\/li>\n\n\n\n<li><code>THE_SHORTEST<\/code>  &#8211; Consider the route with the lowest mileage.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>vehicleType<\/code>&nbsp;\u2013 Type of vehicle to be used on the route. The vehicle&#8217;s weight, height and specific characteristics will be considered to return the appropriate route. The default value, if the parameter is not provided, is <code>TRUCK_WITH_TWO_DOUBLE_AXLES<\/code>. Possible values \u200b\u200bare:\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; Indicates that the route will have to deviate from certain types of road system elements. Allowed values are:\n<ul class=\"wp-block-list\">\n<li><code>TUNNELS<\/code>  &#8211; The route will bypass tunnels;<\/li>\n\n\n\n<li><code>BRIDGES<\/code>  &#8211; The route will bypass bridges;<\/li>\n\n\n\n<li><code>FERRIES<\/code> &#8211; The route will bypass ferries.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>avoidanceBehavior<\/code>&nbsp;\u2013 Indicates what the route planner&#8217;s behavior should be if the route has road elements that must be avoided declared in&nbsp;<code>avoidanceTypes<\/code>. Allowed values are:\n<ul class=\"wp-block-list\">\n<li><code>FAIL<\/code>&nbsp;\u2013 Default API behavior if the parameter is not provided. If it is not possible to complete a route without passing through an element to be avoided, an error message will be returned. For example, an error message will be returned when using&nbsp;<code>\"avoidanceTypes\":[\"FERRIES\"]<\/code>&nbsp;on a route where one of the points can only be reached by ferry;<\/li>\n\n\n\n<li><code>STRONG<\/code>&nbsp;\u2013 The elements will be avoided, but if it is not possible to complete the route without passing through any of the elements, the route will still be returned. For example, a route where one of the points can only be accessed by ferry will be returned even using <code>\"avoidanceTypes\":[\"FERRIES\"]<\/code>&nbsp;;<\/li>\n\n\n\n<li><code>RELAXED<\/code>&nbsp;\u2013 Road elements will not be completely avoided, but the route with the least amount of these elements will be prioritized.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>toll<\/code>  &#8211; Indicates that the route must report the toll calculation. The following parameters must be entered:\n<ul class=\"wp-block-list\">\n<li><code>vehicleType<\/code> &#8211; Text defining the type of vehicle to be considered when calculating the toll. The possible values are: <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><ul> <\/ul><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>crossedBorders<\/code> &#8211; Only for routes in Brazil. Indicates that some information about the route should also be returned:\n<ul class=\"wp-block-list\">\n<li><code>level<\/code>  &#8211; It will return the cities or states that the route crosses. Possible values:\n<ul class=\"wp-block-list\">\n<li><code>CITY<\/code><strong> <\/strong>&#8211; Return to the cities crossed by the route.<\/li>\n\n\n\n<li><code>STATE<\/code>  &#8211; Returns the states crossed by the route.<\/li>\n\n\n\n<li><code>NONE<\/code>  &#8211; The parameter will not be used.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>reverseGeocode<\/code>  &#8211; The <a href=\"https:\/\/developers.maplink.global\/reverse-geocode-api\/\" data-type=\"post\" data-id=\"1241\">Reverse Geocode API<\/a> will be used to return more information about important points on the route. Possible values:\n<ul class=\"wp-block-list\">\n<li><code>START_END<\/code>  &#8211; The fields <code>startAddress<\/code> and <code>endAddress<\/code> will be returned with information on the first and last points on the route.<\/li>\n\n\n\n<li><code>START_END_LEGS<\/code>  &#8211; The field <code>firstPointAddress<\/code> will be returned within each <em>leg (<\/em>section of the route), with information on the starting point of the <em>leg <\/em>in question.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>callback<\/code>  &#8211; Only available in Asynchronous Trip. It contains the <em>callback <\/em>data, which is a <em>webhook <\/em>URL for receiving the problem&#8217;s calculation events. The possible arguments are:\n<ul class=\"wp-block-list\">\n<li><code>url<\/code>  &#8211; URL with the address that will receive the <em>callback<\/em>.<\/li>\n\n\n\n<li><code>user<\/code>  &#8211; Text with the user name if the <em>webhook <\/em>requires authentication<em>.<\/em><\/li>\n\n\n\n<li><code>password<\/code>  &#8211; Password text in case the endpoint needs authentication.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>restrictionZones<\/code>  &#8211; Array with the text of the name of the restriction area previously registered in the <a href=\"https:\/\/developers.maplink.global\/construindo-requisicoes-para-restriction-zone-api\/\" data-type=\"post\" data-id=\"1321\">Restriction Zone API<\/a><\/li>\n\n\n\n<li><code>place<\/code>  &#8211; Used to return points of interest (POIs) on the route. The following parameters must be entered:\n<ul class=\"wp-block-list\">\n<li><code>bufferRouteInMeters<\/code>  &#8211; Integer with the search radius of points of interest along the route. Limit of 500 meters.<\/li>\n\n\n\n<li><code>bufferStoppingPointsInMeters<\/code>  &#8211; Integer with the search radius for points of interest at the stops. Limit of 500 meters.<\/li>\n\n\n\n<li><code>onlyMyPlaces<\/code>  &#8211; Boolean value that indicates whether only establishments from your own base will be returned or whether the service&#8217;s native base should also be used. To find out more, consult the <a href=\"https:\/\/developers.maplink.global\/construindo-requisicoes-para-a-pois-api\/\" data-type=\"post\" data-id=\"1297\">POIs API<\/a> documentation.<\/li>\n\n\n\n<li><code>categories<\/code>  &#8211; Array with the categories of the desired establishments.<\/li>\n\n\n\n<li><code>subCategories<\/code>  &#8211; (Optional) Array with the subcategories of the desired establishments.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>Below is an example with all the optional parameters:<\/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 }<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Mandatory parameters Example: Optional parameters Below is an example with all the optional parameters:<\/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":[161],"tags":[],"class_list":["post-2545","post","type-post","status-publish","format-standard","hentry","category-trip-en"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2545","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/comments?post=2545"}],"version-history":[{"count":7,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2545\/revisions"}],"predecessor-version":[{"id":3537,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2545\/revisions\/3537"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/media?parent=2545"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/categories?post=2545"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/tags?post=2545"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}