Exemplo de localizador de lojas em ASP para o MapPoint Web Service

  • Artigo

Joe D. Como - Microsoft Corporation

Agosto de 2004

Aplica-se a:

  • Microsoft MapPoint Web Service, versão 3.5

Resumo: Aprenda a instalar e a executar um aplicativo localizador de lojas criado com o ASP (Active Server Pages) e que utiliza o Microsoft MapPoint Web Service. (4 páginas impressas)

Clique aqui para baixar o exemplo de código deste artigo e clique aqui para obter as instruções de instalação.

Nesta página

Introdução
Requisitos
Instalando o Localizador de lojas em ASP
Conclusão

Introdução

O ASP (Active Server Pages) não foi desenvolvido para empregar os serviços da Web, como o Microsoft MapPoint Web Service, pois os serviços da Web não existiam quando o ASP foi criado. Por outro lado, o MapPoint Web Service se beneficia especificamente dos avanços trazidos com o ASP.NET e o Microsoft .NET Framework. No entanto, muitas empresas continuam usando versões mais antigas do ASP e não podem converter seus aplicativos em ASP.NET. Cientes desse fato, criamos um aplicativo Localizador de lojas em ASP de exemplo que funciona com o MapPoint Web Service.

O Localizador de lojas em ASP usa dados de exemplo de uma empresa fictícia denominada Fourth Coffee Company. O aplicativo pode geocodificar um endereço ou lugar informado pelo usuário e executar uma pesquisa por proximidade de locais nos arredores que estejam armazenados na fonte de dados de exemplo da Fourth Coffee no MapPoint. Com isso, os usuários podem fazer com que o Localizador de lojas calcule o trajeto ou mostre um mapa detalhado de qualquer um dos locais resultantes da pesquisa por proximidade. É possível personalizar o Localizador de lojas em ASP a fim de incluir suas próprias imagens de marca, além de fazer consultas aos dados que você tiver carregado no site de Atendimento ao cliente do MapPoint Web Service.

Observação: É necessário ser cliente do MapPoint Web Service para acessar o site de Atendimento. Para obter mais informações sobre o MapPoint Web Service ou para inscrever-se em uma conta de avaliação, visite o site do MapPoint Web Service

O Localizador de lojas em ASP consiste em arquivos ASP, que fornecem a interface do usuário, e em arquivos de classe do Microsoft Visual Basic, que são compilados em uma DLL (usando o Visual Basic 6.0 com Service Pack 5) e oferecem as funcionalidades subjacentes. O Kit de Ferramentas para SOAP é utilizado para gerar um arquivo WSML (Web Services Meta Language) que mapeia as operações do MapPoint Web Service descritas no arquivo WSDL do MapPoint Web Service para métodos específicos no objeto COM (a DLL). O arquivo WSML determina qual objeto deve ser carregado para que seja atendida a solicitação de cada operação.

Requisitos

Antes de instalar o Localizador de lojas em ASP, é necessário que os seguintes softwares estejam instalados no computador:

  • Serviços de Informações da Internet (IIS) 5.0 com as atualizações de segurança mais recentes

  • Microsoft Windows 2000 Server, Windows XP Professional ou Microsoft Windows Server 2003

  • Kit de Ferramentas para SOAP 3.0 da Microsoft

  • Microsoft Visual Basic 6.0 com Service Pack 5

Também é necessário ter uma conta válida do MapPoint Web Service. Para obter mais informações sobre o MapPoint Web Service ou para inscrever-se em uma conta de avaliação, visite o site do MapPoint Web Service.

Instalando o Localizador de lojas em ASP

Depois de instalar os pré-requisitos de software, você pode instalar o Localizador de lojas em ASP.

Para instalar o Localizador de lojas

  1. Baixe o arquivo ASPGeneric.exe e, em seguida, execute a instalação. (Por padrão, a instalação é iniciada automaticamente depois que você descompacta os arquivos contidos em ASPGeneric.exe.)

  2. Navegue até a pasta de instalação especificada durante a instalação (o padrão é C:\Arquivos de Programas\Store Locator using ASP). Clique duas vezes em ASPGeneric.exe. Em seguida, descompacte os arquivos contidos no executável.

  3. Crie duas pastas no mesmo nível no computador. Uma delas conterá os arquivos ASP e as imagens do aplicativo. A outra conterá a DLL, o arquivo WMSL e o arquivo WSDL.

  4. Configure a pasta dos arquivos ASP da forma a seguir. Depois, copie para essa pasta o conteúdo da pasta Asp que você acabou de descompactar:

    • Clique com o botão direito do mouse na pasta. Clique em Propriedades e na guia Compartilhamento na Web.

    • Clique em Compartilhar esta pasta. Em seguida, na caixa Editar alias, abaixo de Permissões de aplicativo, certifique-se de que a opção Scripts esteja selecionada.

    • Clique em OK e em Aplicar.

  5. Copie na segunda pasta os seguintes arquivos da pasta MapPointTypeMappers que você acabou de descompactar:

    • MapPointTypeMappers.dll

    • MapPoint.wsdl

    • MapPointSoapServices30.wsml

  6. Use o RegSvr32.exe para registrar o arquivo MapPointTypeMappers.dll:

    • Abra um prompt de comando, mude para o diretório que contém a DLL e, em seguida, digite a seguinte linha:

      regsvr32 MapPointTypeMappers.dll

  7. Na pasta que contém os arquivos ASP, utilize um editor de texto para abrir o arquivo Constants.asp, substituindo os valores padrão pelas seguintes constantes:

    • MAPPOINT_USER_ID — Seu nome de usuário do MapPoint Web Service

    • MAPPOINT_PASSWORD — Sua senha do MapPoint Web Service

    • MAPPOINT_WSDL_URL — O caminho do arquivo MapPoint.wsdl que copiou no computador

    • MAPPOINT_WSML_FILE — O caminho do arquivo MapPointSoapServices30.wsml que você copiou no computador

    • LOCATOR_LOG_FILE — O caminho do arquivo no qual será gravado log de suas transações

Neste ponto, o aplicativo já deverá estar em execução. Para testá-lo, abra um navegador da Web e digite a URL da pasta que contém os arquivos ASP (https://localhost/YourFolderName). Se não for exibida a primeira página do aplicativo, talvez seja necessário modificar algumas configurações de segurança de seu servidor Web.

Para modificar as configurações de segurança

  1. No Gerenciador dos Serviços de Informações da Internet, configure o IIS para permitir acesso anônimo por meio da conta IUSR_NomeDoServidor e para permitir que o IIS controle a senha.

  2. Conceda à conta IUSR_NomeDoServidor acesso de leitura à pasta em que está localizado o arquivo MapPointTypeMappers.dll.

  3. Conceda à conta IUSR_NomeDoServidor acesso de leitura e gravação à pasta na qual será gravado o log.

  4. Use o Regedit.exe para conceder à conta IUSR_NomeDoServidor acesso de leitura às chaves HKEY_CLASSES_ROOT\Interface e HKEY_CLASSES_ROOT\TypeLib do Registro.

Cuidado A edição incorreta do Registro poderá causar graves problemas, que poderão exigir a reinstalação do sistema operacional. A Microsoft não pode garantir que será possível solucionar problemas resultantes da edição incorreta do Registro. Antes de editar o Registro, faça um backup de todos os dados importantes.

Depois de alterar as configurações, é possível exibir o aplicativo das seguintes formas:

  • Interface regular — Acessível em http://hostlocal/NomeDaPasta/default.asp

  • Interface do Pocket PC — Acessível em http://hostlocal/NomeDaPasta/PPCInputForm.asp

  • Interface do anúncio em faixa — Acessível em http://hostlocal/NomeDaPasta/banner.html. Essa página mostra formulário HTML sobreposto a um elemento gráfico de faixa.

Conclusão

O ASP é uma plataforma antiga. Portanto, aproveitar as tecnologias atuais (como os serviços da Web) e empregá-las com o ASP não é uma tarefa simples. Mas, com este Localizador de lojas em ASP, os fundamentos sobre como interagir com o MapPoint Web Service estão disponíveis para você. E você pode expandir este aplicativo, adequando-o aos seus requisitos pessoais. Se não for possível atualizar para o ASP.NET, este código de exemplo oferecerá uma boa base para a criação do seu aplicativo.

Joe D. Como é engenheiro de desenvolvimento para a Web da Unidade de Negócios Microsoft MapPoint e membro da equipe de Serviços Profissionais.

© .