Diferenças

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

--- wiki:obterrotas [2013/07/05 17:19] – coppe
+++ wiki: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.
-    * //raioDeBusca//: 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&raioDeBusca=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>