Obter Rotas - API versão 0.9

• 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.

URL de requisição:

http://api.vadeonibus.com.br/VdoWS0.9/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:

{
  "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
}