Um tour guiado pelo MapPoint Web Service e pelo MapPoint Location Server

Microsoft Corporation

Setembro de 2004

Aplica-se a:

  • Microsoft MapPoint Web Service, versão 3.5

  • Microsoft MapPoint Location Server, versão 1.0

Resumo: Conheça os principais recursos do Microsoft MapPoint Web Service e do MapPoint Location Server por meio de um artigo baseado em cenário e dos vídeos que o acompanham. Este artigo também contém links para páginas em inglês. (7 páginas impressas)

Nesta página

Introdução
Iniciando
Obtendo trajetos e distâncias
Carregando dados personalizados
Obtendo locais em tempo real
Encontrando locais em uma rota
Encontrando locais nas proximidades
Recursos

Introdução

Este artigo fornece um tour guiado pelos recursos do Microsoft MapPoint Web Service e do Microsoft MapPoint Location Server. Por meio da análise dessas tecnologias feita por uma especialista fictícia da área técnica, este artigo apresenta os recursos básicos e demonstra como você pode usá-los nos aplicativos baseados em localização. Os recursos apresentados neste artigo são também ilustrados em cinco vídeos, com instruções passo a passo que mostram como criar rapidamente uma solução simples, porém eficiente.

Depois de ler este artigo e assistir aos vídeos, você estará bastante familiarizado com o MapPoint Web Service e o MapPoint Location Server, e poderá escolher áreas de interesse especial a serem pesquisadas mais profundamente.

Iniciando

Sofia está na sala de espera de um aeroporto pensando em como passar a próxima hora antes de seu vôo para Nova York. Como especialista da área técnica da Fabrikam Corporation, ela é responsável por representar a empresa em assuntos técnicos. A empresa tem tido muito sucesso e, ontem, mais dois representantes de vendas foram adicionados à equipe de Sofia, que agora tem 40 pessoas. Ela e sua equipe viajam muito, e ela se perguntava de que forma poderia usar suas habilidades técnicas para facilitar a sua vida e a de sua equipe.

Recentemente, Sofia leu um artigo sobre o MapPoint Web Service e o MapPoint Location Server e deseja experimentá-los. Antes de viajar, ela se inscreveu em uma conta de avaliação do MapPoint Web Service e também baixou e instalou o MapPoint Location Server. Além disso, baixou os SDKs (Software Development Kits) do MapPoint Web Service e do MapPoint Location Server. (Para obter mais informações sobre como se inscrever em uma conta de avaliação do MapPoint Web Service ou sobre como baixar os SDKs ou o MapPoint Location Server, consulte Recursos.)

Sofia guarda a cópia mais recente da revista do MSDN e pega o laptop. Ela vai explorar o SDK do MapPoint Web Service para tentar criar um aplicativo baseado em localização para si mesma e sua equipe.

O Microsoft MapPoint Web Service, criado em 2001, fornece um meio, independente de plataforma e de idioma do aplicativo, de integrar a inteligência de localização a aplicativos e processos comerciais. Com o MapPoint Web Service, as empresas podem criar aplicativos que acessam um vasto repositório de dados cartográficos de mais de 24 países da Europa e da América do Norte, bem como mais de 200.000 pontos comerciais de interesse e mais de 16 milhões de diretórios comerciais. O MapPoint Web Service foi criado com base em padrões abertos da Internet, como XML e SOAP, e inclui uma API que engloba os seguintes serviços:

  • Find — fornece classes que podem ser usadas para localizar endereços, entidades geográficas, coordenadas de latitude e longitude e pontos de interesse, bem como analisar endereços e retornar informações de localização de uma coordenada de latitude e longitude específica.

  • Render — fornece classes que podem ser usadas para processar mapas de rotas e locais encontrados, marcar pontos com pinos, definir o tamanho e o modo de exibição do mapa, selecionar pontos em um mapa, obter informações de localização sobre os pontos de um mapa, aplicar visão panorâmica e zoom a um mapa processado e criar mapas de imagem.

  • Route — fornece classes que podem ser usadas para traçar rotas, trajetos e representações calculadas de rota com base em locais ou pontos ao longo do caminho, definir preferências de segmento e de rota e gerar modos de exibição de mapa dos segmentos e trajetos.

  • Common — fornece classes comuns aos serviços Find, Route e Render ou que contêm funções básicas do utilitário.

O MapPoint Web Service tem a garantia da Microsoft de 99,99% de disponibilidade. Ao criar aplicativos que interagem com o MapPoint Web Service, as empresas podem acessar a eficiência dos serviços baseados em localização, sem precisar adquirir nem manter uma dispendiosa solução GIS (sistema de informações geográficas).

Obtendo trajetos e distâncias

O primeiro aplicativo no qual Sofia trabalha resolve um problema que lhe causou várias dores de cabeça nos últimos anos. Alguns dos membros de sua equipe iam com seus próprios carros para o aeroporto ou para compromissos com clientes, e enviavam a quilometragem rodada nos relatórios de despesas. No entanto, a maioria dos membros da equipe fazia uma estimativa da distância, o que resultava em reembolso excessivo ou insuficiente. Sofia começa a trabalhar em um aplicativo simples, que produzirá trajetos do ponto A até o ponto B e registrará a quilometragem calculada em um banco de dados. Essa solução garantirá o reembolso justo para todos.

Um aplicativo baseado em localização deve ser capaz de encontrar um local com base em uma informação conhecida, como um endereço. Usando o Microsoft MapPoint Web Service, você pode procurar um endereço, como 1 Microsoft Way, o nome de um local, como Central Park, ou o código de um aeroporto, como LAX. Para cada pesquisa bem-sucedida, o MapPoint Web Service retorna um par de coordenadas de latitude e longitude. Se as informações fornecidas na solicitação de pesquisa não puderem ser usadas para identificar de forma exclusiva um único local, o MapPoint Web Service retornará vários resultados para que você faça as suas escolhas. Depois de localizar os endereços de origem e destino, você pode recuperar facilmente os trajetos e a distância com o serviço Route, usando o método CalculateRoute. No aplicativo de Sofia, a etapa final é armazenar a rota, as informações do usuário, a data e a distância em um banco de dados que os usuários possam acessar posteriormente, durante o preenchimento de seus relatórios de despesas.

No primeiro vídeo, você aprenderá a usar os serviços Find, Route e Render do MapPoint Web Service. O vídeo usa dois métodos do serviço Find para localizar um endereço com base nas informações sobre a rua e um aeroporto com base no código. O vídeo mostra, então, como obter o trajeto detalhado e a quilometragem total. Finalmente, ele demonstra como usar o serviço Render para exibir um mapa com a rota escolhida realçada.

MapPoint Tour: Find, Route, and Render Services (100 k) (em inglês)

Carregando dados personalizados

Com pouquíssimo código e configuração mínima, Sofia conseguiu criar um aplicativo personalizado que ela e os membros da equipe poderão acessar em um laptop ou Smartphone. Encorajada pelo sucesso, Sofia decide ampliar o aplicativo.

Quando ela e sua equipe estão viajando, nem sempre é fácil encontrar uma conexão com a Internet. Ultimamente, eles têm usado uma planilha do Microsoft Excel para registrar os aeroportos, as livrarias e os cafés que oferecem pontos de acesso Wi-Fi. Mas a lista não é fácil de pesquisar e, além disso, não indica o ponto de acesso mais próximo do local em que o usuário se encontra. Se Sofia pudesse incorporar as localizações dos pontos de acesso Wi-Fi ao seu aplicativo e exibi-las em uma mapa, ela e a equipe poderiam localizar facilmente o ponto de acesso mais próximo e acessar a conexão. Para isso, Sofia usará um recurso do MapPoint Web Service que foi introduzido no MapPoint Web Service 3.5: o serviço Customer Data.

Com o serviço Customer Data, os clientes podem carregar suas próprias fontes de dados personalizadas nos servidores do MapPoint Web Service. Os dados podem ser carregados em qualquer formato delimitado, no formato do Microsoft Access ou do Excel, ou em XML. Os dados podem ser até mesmo compactados, o que reduz bastante o tempo de carregamento. É possível carregar até 25 fontes de dados, cada uma contendo no máximo 8,75 milhões de células pesquisáveis e não-booleanas. Depois de carregar uma fonte de dados personalizada, os usuários podem pesquisar essa fonte da mesma forma que pesquisam as fontes de dados predefinidas que o MapPoint Web Service oferece.

Cada item, ou entidade, de uma fonte de dados é identificado por um tipo de entidade, pelas coordenadas do local e por até 75 propriedades personalizadas. Por exemplo, cada entidade da lista de Sofia representa um local e tem propriedades personalizadas que indicam se o local contém um ponto de acesso Wi-Fi e qual provedor esse ponto utiliza. Sofia usará essas propriedades personalizadas juntamente com as chamadas aos métodos do serviço Find para filtrar os resultados retornados.

Ela carrega a planilha do Excel nos servidores do MapPoint Web Service. Carrega também um ícone personalizado que ela criou para que os locais que contenham pontos de acesso sejam facilmente identificados quando plotados em um mapa. Agora ela pode localizar o ponto de acesso Wi-Fi mais próximo em seu Smartphone, com base em sua localização atual. Pode até mesmo filtrar os resultados pelo provedor disponível em cada local, o que lhe permitirá escolher o provedor mais econômico.

O segundo vídeo apresenta a API do serviço Customer Data. Nesse vídeo, você verá como carregar uma fonte de dados personalizada que contém informações sobre pontos de interesse. Também veremos como recuperar a fonte de dados personalizada e exibir as informações como pinos em um mapa.

MapPoint Tour: Customer Data Service API (100 k) (em inglês)

Obtendo locais em tempo real

Novamente, Sofia consegue transformar rapidamente suas idéias em um código funcional. Seu aplicativo agora tem dois recursos que pouparão o tempo de todos os membros da equipe. No entanto, digitar o endereço atual para obter trajetos ou procurar um ponto de acesso pode ser cansativo. Quando está viajando, Sofia às vezes não sabe qual é o endereço em que está, o que dificulta a definição de trajetos. Se ela pudesse se localizar e usar essa localização como ponto de partida, poderia eliminar a etapa de digitação do endereço de origem. Além disso, se ela conseguir se localizar, poderá também localizar os membros de sua equipe. Sofia imagina que um aplicativo que mostre a localização de toda a equipe em um determinado momento permitirá que ela associe os representantes de vendas ao pessoal de suporte técnico mais próximo. Por exemplo, ela poderia facilmente enviar o engenheiro de suporte técnico mais próximo para ajudar um representante de vendas caso um cliente tivesse perguntas extremamente técnicas.

Observação: Para proteger sua privacidade, os usuários devem permitir especificamente que outros usuários os localizem.

Sofia consulta novamente a documentação do MapPoint, dessa vez para saber mais sobre o MapPoint Location Server.

O MapPoint Location Server é um novo produto que funciona como uma camada intermediária entre o MapPoint Web Service, a rede de um provedor de local e os dispositivos cliente habilitados para localização, como telefones celulares. Por exemplo, quando Sofia deseja saber sua localização atual, o MapPoint Location Server envia uma solicitação para o provedor de local, que retorna um par de coordenadas de latitude e longitude para o dispositivo habilitado para localização de Sofia. Em seguida, o MapPoint Location Server envia as coordenadas para o MapPoint Web Service, que retorna um mapa mostrando a localização de Sofia.

A figura 1 mostra o fluxo de dados entre o MapPoint Location Server, um provedor de local, o MapPoint Web Service e um cliente.

ms980183.mwsscen(pt-br,MSDN.10).gif

Figura 1. Fluxo de dados do MapPoint Location Server

Ao contrário do MapPoint Web Service, que é hospedado pela Microsoft Corporation, o MapPoint Location Server é implantado na empresa. Ele está disponível para download no Centro de Download da Microsoft. Para usá-lo, é preciso ter uma conta do MapPoint Web Service e um contrato com uma operadora de comunicação móvel que forneça serviços baseados em localização. (Para obter mais informações sobre como baixar o MapPoint Location Server, consulte Recursos.)

Com o servidor de teste que configurou antes de viajar, Sofia cria um aplicativo simples para preencher automaticamente o local de origem nos dois aplicativos anteriores, e adiciona a seu Smartphone um aplicativo simples, que lhe permite obter sua localização atual com o simples toque de um botão.

O terceiro vídeo apresenta a API do serviço MapPoint Location Server. Nesse vídeo, você verá como recuperar informações sobre a localização dos usuários em um MapPoint Location Server e como plotá-las como pinos em um mapa. O vídeo também aborda os esquemas de autenticação usados e os métodos que as operadoras de comunicação móvel utilizam para determinar localizações.

MapPoint Tour: MapPoint Location Server Web Service API (100 k) (em inglês)

Encontrando locais em uma rota

Ao chegar ao quarto do hotel, Sofia usa seu aplicativo para obter o trajeto do hotel até as instalações do cliente. Agora, só falta encontrar um bom local para tomar um café no caminho. Segundo a documentação do MapPoint Web Service, ela pode usar o método FindNearRoute para procurar um ponto de interesse dentro da rota planejada.

O método FindNearRoute do serviço Find retorna uma lista de pontos de dados com base em três itens: uma especificação de rota, uma fonte de dados e a distância em relação ao caminho da rota. Ao usar o método FindNearRoute em um aplicativo, os usuários podem não somente encontrar os locais em uma rota planejada, mas também planejar viagens com base nos recursos disponíveis.

No quarto vídeo, você verá como usar os serviços Find, Route e Render para fazer pesquisas de locais próximos ao longo de uma rota planejada e retornar os dados do ponto de interesse plotados como pinos em um mapa.

MapPoint Tour: Conducting Proximity Searches (100 k) (em inglês)

Encontrando locais nas proximidades

Sofia pretende levar seu cliente para jantar à noite. Para isso, ela precisa encontrar um restaurante italiano perto da empresa do cliente. Ela liga seu laptop e, depois de um rápido exame na documentação do MapPoint Web Service, adiciona outro recurso ao aplicativo. Primeiro, ela obtém sua localização atual usando o aplicativo do Smartphone que criou. Em seguida, executa uma pesquisa nas proximidades usando o método FindNearby do serviço Find. Finalmente, ela pesquisa os restaurantes italianos em uma das fontes de dados do MapPoint Web Service disponíveis ao público e carrega os trajetos em seu Smartphone.

Depois de um jantar bem-sucedido no restaurante, Sofia volta ao hotel. Amanhã de manhã, ela viajará de volta para casa. Ela pretende criar um plano que integre os aplicativos de exemplo à empresa e, então, apresenta a todos os benefícios dos aplicativos baseados em localização.

O vídeo final mostrará como usar o Microsoft MapPoint Location Server e o serviço Find do MapPoint Web Service para localizar um usuário e identificar um ponto de interesse nas proximidades.

MapPoint Tour: Locate a User and Identify a Point of Interest (1000 k) (em inglês)

Recursos

Os recursos a seguir estão disponíveis para o MapPoint Web Service e o MapPoint Location Server. Para obter informações gerais sobre o MapPoint Web Service ou para se inscrever em uma conta de avaliação, visite o site do MapPoint Web Service(em inglês).

Para obter mais informações sobre como programar com o MapPoint Web Service e o MapPoint Location Server, consulte o MapPoint Web Service no MSDN.

Para obter mais informações sobre como programar com o MapPoint Location Server, consulte MapPoint Location Server no MSDN.

Para baixar o SDK do MapPoint Web Service, visite essa página no Centro de Download da Microsoft.

Para baixar o SDK do MapPoint Location Server, visite essa página no Centro de Download da Microsoft.

Para baixar o MapPoint Location Server, visite essa página no Centro de Download da Microsoft.