As requisições para nossa api são feitas através da URL abaixo:
http://api.qualp.com.br/rotas/v4
Para fazer consultas no QualP para uma rota na qual você já possua a polilinha, você deve utilizar o método POST, adicionado os parâmetros descritos abaixo.
As requisições com polilinha existem para pessoas que tem a rota pronta e precisam fazer apenas o cálculo de pedágios, ou desejam consultar locais privados na rota.
Os parâmetros necessários para realizar uma consulta via POST para a versão 4 de nossa api são mostrados abaixo:
{
"polyline": {
"precision": 6,
"string": "llvoo@lgr~|AvKl^pM|d@~Mje@jYvaAjMvc@vI|Y~Kz_@cBvNtJp\vSds@|Mld@fb@zxAvK|_@al@~Rad@lOaJ`DeEr@m{@|~@ug@jj@qQdUe_@ha@_i@pl@mQxQsiAvb@ggApb@kr@fXkIm@yWuJiHyBiHx\yBbLkg@zUkp@hWoXdKgFhBcObGmT|Ist@zZyCrAcDlA{R~GuCrByTp[aRbWjQhl@lYp`AdCfIzXz~@`ZvaAx^tmAtYx`AxZrcAnDzLtT|s@dZlbAbiApvDvNre@jNhb@~FrQO|SSlEuBvIa\faAiKrQyLzP{SdZ{ClEkD|E}BdD{EzGmRrUwKdOeE`HoGdKiLpRgI|NmNr[yGrUeEhNcbA~bDmRro@iOhg@cKb`@uCvSmBbVe@`SGrPG~Rp@hRdB`RnNbp@zNpv@xQlcAvDbV~AvNbAtOd@vRGbQkAh\}Jj~BkCfl@e@jf@oApeAOdP_AduCy@th@uBvkBa@rj@{DlhFi@~v@sArhBs@fuBSdK_Azo@sDhfDe@x~BlBju@hE|x@ve@dnIlKdrB|Dhv@dPzfCtNpsCbGjnA`F`v@pIhuAtCxf@tGnbAjIbsA`Cl_@lBti@Kz`@oAdi@gCv]}Ej`@{Mzo@kJtYsMj\cI|NwNrVuT~\cT`Si`At}@{sApjAiRzQ}QjU{Sj\uHvRgHr[mC~Ry@lJw@bL]`NWhk@jAvr@bBha@~Fpl@xYfjCvMvpAzAlOpJf}@fYzfCbFb\|O|s@~Mli@`Mj`@zmBdlFz_AnoCjSls@pOhaAbIhu@|HlcAzCdUd@tE|G`l@jI|s@~Efh@hb@frDvPb~AjFbf@lEpk@^vb@sBxa@wFj`@gIj[yLnYm}CteHwP~b@uLpf@kIxl@kBp\IrAW|DQpf@|Bnh@pGrj@dZ`dCvXzvBheAdtI`Ktx@fQ`aAhEpRrFpRhYjcAprBpsGxFxRrTtn@`JhWdUde@~FlItB~C|^ti@tObL|OfNr]fTn]jPnsBty@nS`LnSnOxIzJ~LnN`G`InQd^nKv]pElUdC|YLxB|@fNdMrbG`M`cHJ~IpElcEBxRz@x_AXhS`ArZdBjVnDdZ|Gha@tJr`@rIrVxIbUdj@rjAzXnl@|Qbk@lR`{@~]rhBzP|hAzHzcA`FfvAzAtj@@`v@aJtiDuGvdCyHrvCsEfvB{ArcAsA|d@e@vNqBrt@gBjp@eOr}AyEtc@}Vv_CgGpl@cGzj@}Dd_@uM|mA}AtOsBbVwJnkA{YjrCoCzUcN`jAgQj_AoQju@uTbu@iUzo@{Zjo@ud@p{@ap@dy@ys@jz@{bAz~@irAvlAmq@|}@qi@hfA_]rdAkNhp@wLlt@qIvaAG~pA\z}Ah@zj@xBtaGd@rz@BpvDjA|jCKj[JnX`@xkAl@x_B|@pnBnAvm@fCdn@bLrxA~Hnm@pPr_AjStx@f|AfuGzUtbAnw@bfD`l@t|BhL~g@x~@h{D~{@hrDzNje@lR|c@~e@haAvj@r_Add@|r@j]ns@|Oh\pJbUjFbRfNri@fBbLfFp\hKtcA~UdcFhBfb@pJtvB~Ddj@~J~eAtPhaAhLpf@tOpb@rL~\zPz[lf@|x@ti@hu@rZpb@do@`{@ve@v|@`]riAfI~g@rFti@tDtn@Znm@cDju@sIfr@eMhl@{IzZcFjQca@h{@sP~W}^hl@sNzUeq@`fAkKfSg^nn@o[veAwUliAqM`pAmBnvAvFrxAlQxtA`xAbsGzHx[hR|~@vGrcAoAdiAeHlhAaHby@qCdy@`AtbAdEv}@`MdcAfXtmAdg@`oApx@nqAp|Bh}CpJfNhd@bp@ph@tcAp]h`AfUppA`Hdn@nDhq@lC|n@~@b_A`Az~@h@dd@bFfw@`Jdt@|GdcAdI`pAlD|Y|EzVjFbU~FnSjIvSzN|d@jUpa@tkAtgBbaAn{Ajc@dx@|`@~m@|a@bz@nm@|bAptBbpDpkCfrE|N`Wj`@hq@hd@`w@dWze@`Zrd@rYz`@f[r`@bFbGj^b`@~Xdd@fD|JbCbKvAnIt@xLBnNB~CFfDnApq@bI~v@~Cbp@Xb\BbQiMjzD}D``Bch@xcTaSxwHqLpgEuEdgBjBnaApJjz@~Prt@rXds@rj@nbAvUxp@fS~w@~DpWlL`v@zD`WfUhzAhv@vaFrLxv@tDpVzPvgAjf@pgD`CrP~C~S`f@ncDtCdbBkGvuBi@bQoMfmD_Gln@gOru@mT|h@{Utd@c`@je@yb@z[shAls@w|Ct|AcnAnm@urDrrBwqBrdAkmC~zAwfEfpCypCfpB{bClaB{rDneCa`JxhGaw@bj@{d@d_@sf@lo@oZbj@gB~DmTvw@cOlh@wPfm@wRje@uU~^yVxVqPlOcShMmJtEcS`HqWrF}}@dJanAjGsw@pMyu@fSwaAvb@ar@hb@qn@dd@w`@v]mz@`fA_sBtoCwmGfnIwrBdoCgiDpqEurA~eB_h@ls@ybCx|CquA||Ak~CndDqs@vr@}qBpsBog@fh@mzA~{A_c@dc@wdFthFmf@fg@}hGrmGcgHjlH{gHzkH{uF`zFmpCvsCe^d`@mH`HiMvMqtBxtBaq@|r@_oCvoCwhKvoKyoFjsF}sHhwHyhH|kHs{Cn~CajDjkDwm@bo@eg@jf@_QvSeZbZ_bA~aAa_@v^av@hp@iLrLuJbKehAhpAw_Al~@mEdE{eDpgD}mHloHmOvNqfEfhEybFjdFmyBnyByvBhyBky@d~@yv@haA{]hf@iRpWuTj[{y@|mAquAtpBkNbVetB|zCwbErbGcw@jiA_{@boAst@bjAi_@hk@ifA`{Auw@rhAgx@dcAu\t_@{g@~b@ch@|_@o|@~f@{fA~b@u|FrsBo`@~Mk^bQ}OvHaa@hXkYzUyN~MyKpMuQnXqOhWieAlgB__@jf@iVvW}OnN{^|YexB`pA}oBngA}j@p\yWnSuUfT{_@~]gYp\}Vf]iMlTwMtUaNdYeMdZq_A|`Cw_Dj`Iih@~qAkh@|qAeCbG_z@|qBqhCjrGc\jy@uLd[mT~f@q~@pdBuYde@oaBrlC{cAzbB{iAhjBehC|bEiRr[{Q`]}V|r@oId_@_G~b@cDvm@MbL[fY^l^lDxa@hKnr@dH|YpO`w@pGnw@`AnR`@vm@gApa@qFpq@gKxp@kKpb@}Jp[ej@h{Aa\d~@{_CbqGkw@rxBqOhg@iHj_@uGj`@oDt_@_Dba@a@j`@Xd_@rAr_@~Cba@vDzZnFb[tQnx@lb@lpBtThaAlTvaA`K`g@|Gdi@|Dz~@mBnx@uDr_@wG|^iQjp@}HxR}GdOk[|i@o[d_@w\|Yi|@vm@a\hWg[jZs[d`@aZhf@eWjj@kSjk@uR`l@kSjo@{Qxq@_Nnq@yL`r@_mA~~GwPxeAmGfc@uE`k@cA~Se@|TOhWR|Yz@nYfAjZxCtZrH|n@|EpVjFzUhHvTrt@xbCpoApfEjLje@xGhb@nGli@bC`b@rAd_@^tc@eAdd@}Al_@eI|qA{Cto@YlJqE|r@}GppA}Ep`AqGznAoDvb@aGhb@sIfb@qMxa@cL|YeOh\aR|ZmPpWeUvWmTfTyVdTg[pSagJv`Fc[lPg[xQkZrPml@pa@}c@n^ohBhiBig@xf@uR`Sk]x`@_YhX{w@``AwR`Wc`A~{Akm@tcAog@lbA{Snh@gQjj@gQjp@}Lvl@gNtt@oNpu@uOdt@uQvm@oTbo@ce@`fA{g@d~@}U~]iWx[k_@~c@eo@zo@up@fm@qjBn`BwgBb~A}hF|sEs{AbsAq\|Y{pCteCel@ze@c`@h]cRrPeoF`{EkfHjmG{aA`{@wgCf{BipEn}DmwBllB{eB||AgQbPijCb}BuMlKm~DvmD_s@zo@oX|TkQtOcr@ln@}`A~{@{uAnlAk^b\ea@j`@{l@xp@gO|Nsj@b{@a{@|rAoQdYqjA~jBc`@~l@cnDvqFyOlYqb@zo@arAtvBsKrQi`FttH_rAtbBeYha@uf@vw@ofBdeDcQvXwq@xdAa_@bk@kWnb@wvB|eDudBrqCuiCv|Dg}BrpDqlAzhBkQvXuk@l}@swBfdDeZng@sThb@wR|d@mn@`_Bkk@d|AeU`l@e_@z_AmYvr@if@xoAgW~m@ex@dvBqB`HiH~RuWdt@}h@hzA}x@~zBuZbt@}I~Nud@ngAiM~WkLtOgKdJaKzGqGrEkNbLyJpGiJlFyQhGoa@hMqLjF{H`IwTxVyk@hv@eJ|Jm_BthAe|B||AkmBlmAcdAnq@s_Aje@khBf}@ae@lUac@jV{A}@oAF{ATsAd@wCxBi@zAHrAkZdP}RjKyi@rVyoAti@{i@zUeHxBqRtEwU~Csx@fC{n@Ew}@DkoBl@o`Bl@_\Nmy@WwRU_p@u@sz@aBklAqCkxAgCkBOg]]yVWij@s@c|@eAiHUwQFs{@?io@r@kPjB}MrEaJjGeEvCeK|Je_@|^s[p\aWjVmGbGib@vb@sFrFgX~XqJjKwSnT_f@ri@wHrFeNbLwJ|EmSlEcVzAyf@dEk|@`H_nAvWgi@fJyk@lEgj@zEkj@zGil@rE_YfD}Jt@_XhCe}CtTy{@nIou@dEsr@tI_h@~Dan@tDyy@rGnDzy@b\mE"
},
"config":{
"vehicle":{
"type":"truck",
"axis":"all"
},
"tolls": {
"retroactive_date": ""
},
"freight_table":{
"category":"all",
"freight_load":"granel_solido", "axis": "all"
},
"route":{
"calculate_return":false
},
"private_places":{
"max_distance_from_location_to_route":1000,
"categories": true,
"areas": false,
"contacts":false,
"products": false,
"services":false
},
"router": "qualp"
},
"show":{
"polyline":false,
"simplified_polyline": true,
"private_places":false,
"static_image":false,
"freight_table":true,
"link_to_qualp":true,
"maneuvers": true,
"truck_scales": true,
"tolls":true
},
"format":"json",
"exception_key": ""
}
polyline: Neste parâmetro, você informa a polilinha para a qual quer que o qualp retorne os dados da rota.
string: A polilinha codificada no padrão google.precision: A precisão em que a polilinha foi codificada, podendo ser 5 ou 6.config: Neste parâmetro, você configura como quer sua rota.
vehicle: Aqui, será configura o veículo que está utilizando.
axis: Neste parâmetro, deve ser informado o número de eixos de seu veículo. É possivel informar um valor inteiro de 2 a 10, ou então uma string com o valor "all", para retornar os valores de pedágio para todas os eixos.type: Neste parâmetro, deve ser informado o tipo ou categoria do veículo. Estas podem ser: "car", "truck", "moto" ou "bus".tolls: Aqui, é configurado dados relacionados ao pedágio.
retroactive_date: Calcula os preços do pedágio com base nos preços da data informada. Informar a data no formato dd/mm/aaaa. Se for utilizar a data atual, não é necessário informar a data.
freight_table: Neste parâmetro, é possível configurar a tabela frete que será retornada.
category: Aqui, é necessário informar a categoria da tabela frete que deve ser retornada. As categorias podem ser: "A", "B", "C", "D" ou "all", para retornar os dados de todas as categorias.freight_load: Aqui, é informado o tipo de carga para o qual deseja-se a tabela frete. Estes são os valores possíveis: "granel_solido", "granel_liquido", "frigorificada", "conteineirizada", "geral", "neogranel", "perigosa_granel_solido", "perigosa_granel_liquido", "perigosa_frigorificada", "perigosa_conteineirizada", "perigosa_geral", "granel_pressurizada" ou "all", para retornar os dados para todas as cargas.route: Aqui, é configurado dados relacionados a rota.
calculate_return: Com este parâmetro, você define se a volta deve ser calculada. Os valores possíveis são true e false.private_places: Neste parâmetro, você define como devem ser retornados os locais privados presentes na rota.
max_distance_from_location_to_route: Esta é a distância máxima do ponto geogŕafico cadastrado para o local até o ponto da rota mais próximo deste local, e é definido em metros.categories: Define se as categorias do local devem ser retornadas junto com os dados do local. Deve ser informado true ou false.areas: Define se as áreas do local devem ser retornadas junto com os dados do local. Deve ser informado true ou false.contacts: Define se os contatos do local devem ser retornadas junto com os dados do local. Deve ser informado true ou false.products: Define se os produtos vendidos no local devem ser retornadas junto com os dados do local. Deve ser informado true ou false.services: Define se os serviços ofertados no local devem ser retornadas junto com os dados do local. Deve ser informado true ou false.show: Este parâmetro define quais os dados que serão retornados por nossa api.
polyline: Define se a polilinha da rota será ou não retornada pela api. Deve ser informado true ou false.simplified_polyline: Define se a polilinha simplificada da rota será ou não retornada pela api. Deve ser informado true ou false.private_places: Define se os locais privados presentes na rota serão ou não retornada pela api. Deve ser informado true ou false.static_image: Define se a imagem estática da rota será ou não retornada pela api. Deve ser informado true ou false.freight_table: Define se a tabela frete será ou não retornada pela api. Deve ser informado true ou false.link_to_qualp: Define se um link para abrir a rota no site do qualp será ou não retornada pela api. Deve ser informado true ou false.maneuvers: Define se o rotograma da rota será retornado ou não. Deve ser informado true ou false.truck_scales: Define se as balanças presentes na rota será retornado. Deve ser informado true ou false.tolls: Define se as informações referentes a praças de pedágio serão ou não retornados pela API.format: Define o formato da resposta, podendo ser json ou xml.
exception_key: Com esse parâmetro é possivel utilizar a exceção que você pussui cadastrada para essa rota, basta informar a chave da exceção.
A versão 4 de nossa API oferece o formato json como formato de resposta padrão, mas você pode
alterá-lo para XML caso necessário. Essa alteração é feita através do parâmetro format, que
aceita os valores json e xml.
...
"format": "json"
...
...
"format": "xml"
...
Os parâmetros mostrados acima devem ser enviados na URL de consulta, no formato json através do parâmetro json:
https://api.qualp.com.br/rotas/v4?json={"locations": ["Curitiba - PR",{"lat":-22.263797,"lng":-47.902534}],"config":{"vehicle":{"type":"truck","axis":"all"},"freight_table":{"category":"all","freight_load":"granel_solido", "axis": "all"},"route":{"calculate_return":false},"private_places":{"max_distance_from_location_to_route":1000, "categories": true, "areas": false, "contacts":false, "products": false, "services":false}},"show":{"polyline":false,"private_places":false,"static_image":false,"freight_table":true,"link_to_qualp":true,"tolls":true},"format":"json"}
Quando você faz uma requisição via
GET, não é possível enviar uma polilinha. Para isso, utilize o métodoPOST