Os Web Services dispõe operações com funcionalidades para processos de geocodificação, geração de rotas, renderização de mapas, informações de trânsito e busca por pontos de interesse.

Estrutura

Os serviços são acessíveis através do protocolo SOAP (Simple Object Access Protocol). Este protocolo trata-se de uma especificação que possibilita a troca de informações de uma forma estruturada.

As mensagens trocadas entre o requisitante e o serviço adotam o padrão de formato de mensagens em XML (Extensible Markup Language).

Token de Acesso

Para qualquer requisição feita a uma das operações dos Web Services disponíveis é necessário informar o token de acesso, onde a partir dele é possível identificar o usuário requisitante e validar a permissão de acesso aos dados solicitados.

Você pode solicitar um token de acesso provisório com validade para 7 dias e de forma gratuita. Solicite a sua chave de testes através deste endereço.

Primeiros passos

A documentação dos serviços e operações, juntamente com exemplos de código para consumo e leitura dos dados recebidos como retorno, estão disponíveis e são citados ao decorrer desta seção. Para entendimento da estrutura destes exemplos, recomenda-se a leitura do guia primeiros passos, onde são detalhados os ambientes .NET e Java, além de requisições diretas por XML, sendo estas as tecnologias adotadas para apresentar uma forma de utilização dos web services.

Serviços e operações disponíveis

A relação dos serviços disponíveis, suas funcionalidades e operações estão contidos na estrutura abaixo:

AddressFinder

Geocodificação
Disponibiliza através de suas operações as funcionalidades de geocodificação, geocodificação reversa ou por cruzamentos, busca por informações de uma cidade e obtenção de um mapa renderizado a partir de um endereço informado.
Relação de operações disponíveis:

  • Busca de Endereços
  • Busca de Cidades
  • Busca de Pontos de Interesse
  • Obter Endereço por Coordenadas
  • Obter Cruzamento de Endereços por Coordenadas
  • Obter Coordenadas por Cruzamento de Endereços
  • Obter Coordenadas por Endereço
  • Obter Mapa Renderizado por Endereço

mais informações

Proximity

Pontos de Estabelecimento por Proximidade
Disponibiliza através de suas operações as funcionalidades de busca por pontos de interesse considerando como filtro por proximidade um endereço, coordenadas geográficas, dimensões de um mapa ou raio.
Relação de operações disponíveis:

  • Pontos de interesse com proximidade por endereço
  • Pontos de interesse com proximidade por coordenadas geográficas
  • Pontos de interesse com proximidade por dimensões de mapa
  • Obter Endereço por Coordenadas
  • Pontos de interesse com proximidade por endereço e raio
  • Obter Coordenadas por Endereço
  • Obter Mapa Renderizado por Endereço

mais informações

MapRender

Renderização de Mapas
Disponibiliza através de suas operações as funcionalidades de renderização de mapas através de contextos diversos, considerando a geração por uma área específica em coordenadas geográficas ou por pontos, cidade, estado, além de prover as opções de ampliação e deslocamento da área.
Relação de operações disponíveis:

  • Renderização de mapa por área
  • Renderização de mapa com navegação por deslocamento
  • Renderização de mapa com ampliação
  • Renderização de mapa por cidade
  • Renderização de mapa com área máxima
  • Renderização de mapa por coordenadas e raio
  • Renderização de mapa por estado
  • Renderização de mapa com ampliação por pontos

mais informações

Route

Geração de Rotas
Disponibiliza através de suas operações as funcionalidades de geração de rotas simples, múltiplas e com percursos alternativos, além de obter dados de custos com o trajeto da rota e sumarizados, além de opção para renderização de mapa a partir de uma roteirazão entre pontos de parada.
Relação de operações disponíveis:

  • Geração de rotas
  • Geração de rotas com percursos alternativos
  • Geração de múltiplas rotas
  • Cálculo de valores totais por rota
  • Cálculo de valores totais por conjunto de rotas
  • Obter dados de resumo por rota
  • Obter dados de descrição por rota
  • Renderização de mapa por rota
  • Serviço localizador de coordenadas em rotas

mais informações

RouteProximity

Geração de Rotas com Pontos de Interesse por Proximidade
Disponibiliza através de suas operações as funcionalidades de geração de rotas simples, possibilidade de obter dados de descrição dos trajetos e a renderização de mapa por rota, onde estes métodos possuem em seu retorno os pontos de interesse por proximidade existentes no trajeto sugerido para a rota em questão. Adicionalmente, é possível ter como resultado somente a lista com os pontos de interesse por proximidade para o percurso da rota, e por fim, estão disponíveis operações adicionais para cálculo de rotas, sendo elas, obter dados de custos com o trajeto da rota e dados sumarizados.
Relação de operações disponíveis:

  • Geração de rotas com pontos de interesse por proximidade
  • Obter dados de descrição por rota e pontos de interesse por proximidade
  • Renderização de mapa por rota com pontos de interesse por proximidade
  • Obter pontos de proximidade por rota
  • Obter dados de resumo por rota
  • Cálculo de valores totais por rota
  • Cálculo de valores totais por conjunto de rotas

mais informações

Traffic

Informações de Trânsito
Disponibiliza através de suas operações as funcionalidades de busca de informações de trânsito, considerando corredores específicos, por localização (cidade e estado) ou por categorias, podendo por exemplo, verificar trechos com obras na via ou com incidentes de alagamentos, acidentes, entre outras situações que venham a compremeter o tráfego em um determinado ponto. Adicionalmente, estão disponíveis as opções para obtenção de notícias de trânsito, sendo estas sincronizadas com as ocorrências geradas no site da MapLink – Incidentes.
Relação de operações disponíveis:

  • Informações gerais de trânsito
  • Informações de corredores
  • Informações de trechos por corredor
  • Informações sumarizadas de trânsito por localidade
  • Informações de localidade
  • Busca de categorias por localidade
  • Busca de subcategorias por categoria e localidade
  • Notícias gerais de trânsito por localidade
  • Notícias de problemas de trânsito por localidade
  • Notícias de problemas de trânsito por subcategoria e localidade

mais informações

ClientDataAdmin

Gerenciamento de registros da base de dados
Disponibiliza através de suas operações as funcionalidades de remoção de registros de uma tabela, busca de registros de uma tabela, inserção de registro em uma tabela e atualização de dados de registros de uma tabela.
Relação de operações disponíveis:

  • Remoção de registros
  • Consulta de registros
  • Inserção de registro
  • Atualização de dados de registros

mais informações