Ferramentas do usuário

Ferramentas do site


wiki:obterrotas

Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anteriorRevisão anterior
Próxima revisão
Revisão anterior
wiki:obterrotas [2013/07/03 14:42] coppewiki:obterrotas [2013/08/14 16:13] (atual) – removed coppe
Linha 1: Linha 1:
-====== Obter Rotas ====== 
  
-  * **Descrição**: Calcula rotas entre uma origem e um destino. 
-  * **Nome do serviço na URL**: obterrotas 
-  * **Parâmetros**: 
-    * //token//: código de identificação do usuário. 
-    * //origemMunicipio//: município do endereço de origem. 
-    * //origemNumero//: número do endereço de origem (default = 1). 
-    * //origemLogradouro//: rua/avenida do endereço de origem. 
-    * //destinoMunicipio//: município do endereço de origem. 
-    * //destinoNumero//: número do endereço de origem (default = 1). 
-    * //destinoLogradouro//: rua/avenida do endereço de destino. 
-    * //origemX//: coordenada X(longitude) do ponto de origem. 
-    * //origemY//: coordenada Y(latitude) do ponto de origem. 
-    * //destinoX//: coordenada X(longitude) do ponto de destino. 
-    * //destinoY//: coordenada Y(latitude) do ponto de destino. 
-    * //radioDeBusca//: distância em metros da caminhada entre o ponto de origem e o ponto de embarque (default = 500, ou seja, 500 metros). 
-    * //metodoOrdenacao//: preferência de ordenação do resultado (default = 0). Os valores podem ser 0, 1, 2 ou 3, significando menor custo total (R$), menor distância percorrida (em quilômetros), menor caminhada (em metros), mínimo de transbordos, respectivamente. 
-    * //preferencia//: parseamento da string de vista da linha, ordenando o resultado por 'STRING%', onde STRING é o valor do parâmetro preferência. 
- 
-**Observação:** A origem e o destino podem ser passados como endereço (rua, número, município) ou como ponto geométrico (longitude(x) e latitude(y)). Caso as duas maneiras sejam passadas por parâmetro, a forma de ponto geométrico será priorizada. 
- 
-===== Exemplo ===== 
- 
-URL de requisição: 
- 
-  http://200.201.144.27:8080/VdoWS/vdoconsulta/obterrotas?token=seutoken&origemX=-43.180046&origemY=-22.901162&destinoMunicipio=Rio%20de%20Janeiro&destinoLogradouro=Avenida%20das%20Americas&radioDeBusca=1000&metodoOrdenacao=3 
-   
-Retorno do web service: 
- 
-<code javascript> 
-{ 
-  "listaRotaItem":[ 
-    { 
-      "viagens":[ 
-        { 
-          "logradouroOrigem":"Point(-43.180046 -22.901162)", // logradouro de origem 
-          "logradouroDestino":"Avenida das Americas", // logradouro de destino 
-          "pontoEmbarque":{ // primeiro ponto de embarque 
-            "logradouro":"AVENIDA PRESIDENTE VARGAS", 
-            "numero":"593", 
-            "referencia":"BRS 1, 3 - URUGUAIANA", 
-            "geometrico":{ 
-              "x":-43.18164154813372, 
-              "y":-22.902301114135398 
-            } 
-          }, 
-          "pontoDesembarque":{ // primeiro ponto de desembarque 
-            "logradouro":"AVENIDA DAS AMERICAS", 
-            "numero":"4002", 
-            "referencia":"Avenida Das Americas próximo ao 4002", 
-            "geometrico":{ 
-              "x":-43.362338544236884, 
-              "y":-22.999424921534263 
-            } 
-          }, 
-          "caminhadaOrigem_PO":285.0, // Caminhada entre a origem e o ponto de ônibus de embarque em metros 
-          "caminhadaPO_Destino":193.0, // Caminhada entre o ponto de ônibus de desembarque e ponto de destino em metros 
-          "linha":{ 
-            "id":17418997, 
-            "nome":"316 - RECREIO DOS BANDEIRANTES X CENTRAL (VIA LINHA AMARELA) (VIA BOTAFOGO / SERNAMBET", 
-            "empresa":"Consorcio Transcarioca", 
-            "tarifa":2.75, 
-            "municipio":"Rio de Janeiro", 
-            "servico":"", 
-            "vista_sn":" - RECREIO DOS BANDEIRANTES X CENTRAL (VIA LINHA AMARELA) (VIA BOTAFOGO / SERNAMBET", 
-            "numero":"316", 
-            "routeName":"", 
-            "concessionaria":"" 
-          }, 
-          "distancia_PE_PD":33.94, // Distância entre ponto de embarque e ponto de desembarque (em KM) 
-          "distanciaTotal":0.0, 
-          "caminhadaTotal":0.0, 
-          "avisos":[ 
-            "Trajeto sem transbordo ou Ônibus Intermunicipal" 
-          ] 
-        } 
-      ], 
-      "pontoOrigem":{ // ponto de origem em coordenadas geográficas 
-        "x":-43.180046, 
-        "y":-22.901162 
-      }, 
-      "pontoDestino":{ // ponto de destino em coordenadas geográficas 
-        "x":-43.452446933679404, 
-        "y":-23.01034490281672 
-      }, 
-      "rotas":[ // lista dos códigos dos ônibus utilizados para esta opção de trajeto 
-        "17418997" 
-      ], 
-      "totalDinheiro":2.75, 
-      "totalCartao":2.75 // custo total com o cartão bilhete único 
-    }, 
-    { 
-      "viagens":[ 
-        { 
-          "logradouroOrigem":"Point(-43.180046 -22.901162)", 
-          "logradouroDestino":"Avenida das Americas", 
-          "pontoEmbarque":{ 
-            "logradouro":"AVENIDA PRESIDENTE VARGAS", 
-            "numero":"593", 
-            "referencia":"BRS 1, 3 - URUGUAIANA", 
-            "geometrico":{ 
-              "x":-43.18164154813372, 
-              "y":-22.902301114135398 
-            } 
-          }, 
-          "pontoDesembarque":{ 
-            "logradouro":"AVENIDA DAS AMERICAS", 
-            "numero":"4002", 
-            "referencia":"Avenida Das Americas próximo ao 4002", 
-            "geometrico":{ 
-              "x":-43.362338544236884, 
-              "y":-22.999424921534263 
-            } 
-          }, 
-          "caminhadaOrigem_PO":285.0, 
-          "caminhadaPO_Destino":193.0, 
-          "linha":{ 
-            "id":17577667, 
-            "nome":"314 - RECREIO DOS BANDEIRANTES X CENTRAL (VIA COPACABANA / AV. DAS AMERICAS)", 
-            "empresa":"Consorcio Transcarioca", 
-            "tarifa":2.75, 
-            "municipio":"Rio de Janeiro", 
-            "servico":"", 
-            "vista_sn":" - RECREIO DOS BANDEIRANTES X CENTRAL (VIA COPACABANA / AV. DAS AMERICAS)", 
-            "numero":"314", 
-            "routeName":"", 
-            "concessionaria":"" 
-          }, 
-          "distancia_PE_PD":31.9, 
-          "distanciaTotal":0.0, 
-          "caminhadaTotal":0.0, 
-          "avisos":[ 
-            "Trajeto sem transbordo ou Ônibus Intermunicipal" 
-          ] 
-        } 
-      ], 
-      "pontoOrigem":{ 
-        "x":-43.180046, 
-        "y":-22.901162 
-      }, 
-      "pontoDestino":{ 
-        "x":-43.452446933679404, 
-        "y":-23.01034490281672 
-      }, 
-      "rotas":[ 
-        "17577667" 
-      ], 
-      "totalDinheiro":2.75, 
-      "totalCartao":2.75 
-    }, 
-    { 
-      "viagens":[ 
-        { 
-          "logradouroOrigem":"Point(-43.180046 -22.901162)", 
-          "logradouroDestino":"Avenida das Americas", 
-          "pontoEmbarque":{ 
-            "logradouro":"AVENIDA PRESIDENTE VARGAS", 
-            "numero":"593", 
-            "referencia":"BRS 1, 3 - URUGUAIANA", 
-            "geometrico":{ 
-              "x":-43.18164154813372, 
-              "y":-22.902301114135398 
-            } 
-          }, 
-          "pontoDesembarque":{ 
-            "logradouro":"AVENIDA DAS AMERICAS", 
-            "numero":"4002", 
-            "referencia":"Avenida Das Americas próximo ao 4002", 
-            "geometrico":{ 
-              "x":-43.362338544236884, 
-              "y":-22.999424921534263 
-            } 
-          }, 
-          "caminhadaOrigem_PO":285.0, 
-          "caminhadaPO_Destino":193.0, 
-          "linha":{ 
-            "id":17565594, 
-            "nome":"308 - BARRA DA TIJUCA X CENTRAL (VIA COPACABANA/AVENIDA DAS AMERICAS)", 
-            "empresa":"Consorcio Transcarioca", 
-            "tarifa":2.75, 
-            "municipio":"Rio de Janeiro", 
-            "servico":"", 
-            "vista_sn":" - BARRA DA TIJUCA X CENTRAL (VIA COPACABANA/AVENIDA DAS AMERICAS)", 
-            "numero":"308", 
-            "routeName":"", 
-            "concessionaria":"" 
-          }, 
-          "distancia_PE_PD":32.05, 
-          "distanciaTotal":0.0, 
-          "caminhadaTotal":0.0, 
-          "avisos":[ 
-            "Trajeto sem transbordo ou Ônibus Intermunicipal" 
-          ] 
-        } 
-      ], 
-      "pontoOrigem":{ 
-        "x":-43.180046, 
-        "y":-22.901162 
-      }, 
-      "pontoDestino":{ 
-        "x":-43.452446933679404, 
-        "y":-23.01034490281672 
-      }, 
-      "rotas":[ 
-        "17565594" 
-      ], 
-      "totalDinheiro":2.75, 
-      "totalCartao":2.75 
-    }, 
-    { 
-      "viagens":[ 
-        { 
-          "logradouroOrigem":"Point(-43.180046 -22.901162)", 
-          "logradouroDestino":"Avenida das Americas", 
-          "pontoEmbarque":{ 
-            "logradouro":"AVENIDA PRESIDENTE VARGAS", 
-            "numero":"593", 
-            "referencia":"BRS 1, 3 - URUGUAIANA", 
-            "geometrico":{ 
-              "x":-43.18164154813372, 
-              "y":-22.902301114135398 
-            } 
-          }, 
-          "pontoDesembarque":{ 
-            "logradouro":"AVENIDA DAS AMERICAS", 
-            "numero":"4002", 
-            "referencia":"Avenida Das Americas próximo ao 4002", 
-            "geometrico":{ 
-              "x":-43.362338544236884, 
-              "y":-22.999424921534263 
-            } 
-          }, 
-          "caminhadaOrigem_PO":285.0, 
-          "caminhadaPO_Destino":193.0, 
-          "linha":{ 
-            "id":17600089, 
-            "nome":"309 - ALVORADA X CENTRAL (VIA BOTAFOGO/SERNAMBETIBA)", 
-            "empresa":"Consorcio Transcarioca", 
-            "tarifa":2.75, 
-            "municipio":"Rio de Janeiro", 
-            "servico":"", 
-            "vista_sn":" - ALVORADA X CENTRAL (VIA BOTAFOGO/SERNAMBETIBA)", 
-            "numero":"309", 
-            "routeName":"", 
-            "concessionaria":"" 
-          }, 
-          "distancia_PE_PD":34.12, 
-          "distanciaTotal":0.0, 
-          "caminhadaTotal":0.0, 
-          "avisos":[ 
-            "Trajeto sem transbordo ou Ônibus Intermunicipal" 
-          ] 
-        } 
-      ], 
-      "pontoOrigem":{ 
-        "x":-43.180046, 
-        "y":-22.901162 
-      }, 
-      "pontoDestino":{ 
-        "x":-43.452446933679404, 
-        "y":-23.01034490281672 
-      }, 
-      "rotas":[ 
-        "17600089" 
-      ], 
-      "totalDinheiro":2.75, 
-      "totalCartao":2.75 
-    }, 
-    { 
-      "viagens":[ 
-        { 
-          "logradouroOrigem":"Point(-43.180046 -22.901162)", 
-          "logradouroDestino":"Avenida das Americas", 
-          "pontoEmbarque":{ 
-            "logradouro":"AVENIDA RIO BRANCO", 
-            "numero":"71", 
-            "referencia":"Avenida Rio Branco próximo ao 71", 
-            "geometrico":{ 
-              "x":-43.17938459443369, 
-              "y":-22.90055891133423 
-            } 
-          }, 
-          "pontoDesembarque":{ 
-            "logradouro":"AVENIDA DAS AMERICAS", 
-            "numero":"4002", 
-            "referencia":"Avenida Das Americas próximo ao 4002", 
-            "geometrico":{ 
-              "x":-43.362338544236884, 
-              "y":-22.999424921534263 
-            } 
-          }, 
-          "caminhadaOrigem_PO":145.0, 
-          "caminhadaPO_Destino":193.0, 
-          "linha":{ 
-            "id":17533399, 
-            "nome":"2018 - AEROPORTO INTERNACIONAL DO RJ X ALVORADA", 
-            "empresa":"Consorcio Transcarioca", 
-            "tarifa":13.0, 
-            "municipio":"Rio de Janeiro", 
-            "servico":"", 
-            "vista_sn":" - AEROPORTO INTERNACIONAL DO RJ X ALVORADA", 
-            "numero":"2018", 
-            "routeName":"", 
-            "concessionaria":"" 
-          }, 
-          "distancia_PE_PD":35.01, 
-          "distanciaTotal":0.0, 
-          "caminhadaTotal":0.0, 
-          "avisos":[ 
-            "Trajeto sem transbordo ou Ônibus Intermunicipal" 
-          ] 
-        } 
-      ], 
-      "pontoOrigem":{ 
-        "x":-43.180046, 
-        "y":-22.901162 
-      }, 
-      "pontoDestino":{ 
-        "x":-43.452446933679404, 
-        "y":-23.01034490281672 
-      }, 
-      "rotas":[ 
-        "17533399" 
-      ], 
-      "totalDinheiro":13.0, 
-      "totalCartao":13.0 
-    } 
-  ], 
-  "qtdRotasEncontradas":106 // Quantidade total de rotas que foram encontradas 
-} 
-</code> 
wiki/obterrotas.1372862567.txt.gz · Última modificação: 2015/10/05 03:32 (edição externa)