Share via


Adicionar geolocalização

Geolocalização é a identificação do local geográfico real de um objeto. A geolocalização tem uma relação bastante próxima com o uso de sistemas de posicionamento, mas enfatiza mais a determinação de uma localização significativa (por exemplo, um endereço postal) em vez de apenas um conjunto de coordenadas geográficas. A palavra geolocalização também pode significar as coordenadas de latitude e longitude de um local específico.

Um formulário pode ser configurado para exibir um controle do mapa para exibir uma localização existente como um marcador em um mapa ou permitir que o usuário especifique uma localização.

Dados de localização em um formulário.

Se o formulário ou o campo linha de endereço for editável e estiver em branco, então, quando a página da Web for carregada, será perguntado ao usuário se ele deseja compartilhar a localização. Se ele optar por compartilhar a localização, o mapa será atualizado com a localização detectada no momento. O usuário pode refinar o local de fixação, arrastando-o. Caso o usuário opte por não para compartilhar a localização, ele poderá especificar manualmente as partes do endereço nos campos fornecidos e o serviço de mapeamento será consultado para encontrar a localização, atualizar a latitude e a longitude e reposicionar o marcador no mapa adequadamente.

Adicionar geolocalização

Para adicionar a funcionalidade de geolocalização a um formulário, as tarefas a seguir devem ser concluídas.

Personalização de formulários

Edite o formulário básico usando o designer de formulários e faça as alterações a seguir:

  1. Crie uma nova seção e forneça um rótulo adequado, por exemplo, Mapa. Essa seção conterá o mapa.

  2. Defina o nome da seção como section_map ou um nome que termine com section_map, por exemplo, contoso_section_map. Esse nome é importante porque o mecanismo de formulários procura por uma seção com este nome para determinar quando renderizar um mapa.

  3. Adicione um campo existente ou novo que armazenará o endereço formatado e adicione-o à seção Mapa criada na etapa anterior.

  4. Crie uma nova seção e forneça um rótulo adequado, por exemplo Local. Essa seção conterá os campos de endereço da localização selecionada.

  5. Adicione os campos de endereço necessários à seção Localização criada na etapa anterior:

    • Linha do Endereço
    • Cidade
    • Município
    • Estado/Província
    • País/Região
    • CEP
    • Latitude
    • Longitude

O formulário resultante deve ser semelhante ao seguinte: Você pode escolher nomes de exibição diferentes para estes campos. Você também pode escolher o layout dessas seções do modo que preferir.

Formulário personalizado de geolocalização.

Configurações de site

A funcionalidade de geolocalização com mapa em formulários exige definições de configuração para concluir solicitações com o ponto de extremidade REST do serviço de mapeamento. As seguintes configurações de local são usadas para configurar o serviço do local.

Nome Valor
Bingmaps/credentials Chave exclusiva para autenticar solicitações para a API do Bing Mapas. Acesse www.bingmapsportal.com a para criar uma conta do Bing Mapas e obter a chave. Necessário.
Bingmaps/restURL A URL para a API REST do Bing Mapas. Opcional. Se um valor não for especificado, o padrão https://dev.virtualearth.net/REST/v1/Locations será usado.

Configurações de campos

O controle de mapa exige configuração adicional para informar quais são as IDs dos vários campos de localização, de forma que ele atribua ou recupere valores deles. A configuração depende do tipo de formulário gerenciado.