Utilizar parâmetros da URL para modificar mapas embutidos

Anotação:

Esta funcionalidade é atualmente suportada apenas no Map Viewer Classic. Ele estará disponível em uma versão futura do Map Viewer.

O Map Viewer Classic fornece código HTML pronto para uso para embutir um mapa em um site da web. Você pode escolher opções para incluir no mapa, como uma botão de página inicial, controle de zoom e uma legenda, que são adicionados no código que você copia e cola em seu site da web. Outra maneira para adicionar estas opções é utilizar parâmetros da URL.

A URL do mapa embutido sempre inicia com a URL da sua organização ou do site público (https://www.arcgis.com) e /apps/Embed/index.html?webmap=<your web map ID>. Abaixo está um exemplo:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

A URL também pode incluir um ou mais dos parâmetros listados abaixo. Alguns parâmetros da URL modificam o comportamento do mapa embutido enquanto outros modificam quais funcionalidades estão disponíveis no mapa embutido. Para incluir mais de um parâmetro, utilize o sinal gráfico (&) para separar os parâmetros. Abaixo está um exemplo:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

Anotação:

Se algum dos recursos no parâmetro de URL for fornecido como HTTP, você deverá substituir HTTP por HTTPS na URL e tornar todos os recursos acessíveis usando apenas HTTPS.

Layout

Os seguintes parâmetros oferecem controle do visual e comportamento do mapa:

  • theme—Determina o tema de cor aplicado em botões e painel lateral. As opções válidas são light ou dark.
  • legend—Ao configurar para true, uma legenda é exibida no painel lateral mostrando as camadas no mapa.
  • details—Ao configurar para true, o texto de descrição do mapa aparece no painel lateral.
  • active_panel—Configura qual guia está ativa no painel lateral quando o mapa carregar. As opções válidas são legend ou details. O parâmetro legend ou details deve ser configurado para true se utilizado como o valor do parâmetro active_panel.
  • show_panel—Ao configurar para true, o painel lateral é exibido quando o mapa carregar. O padrão é false.
  • popup_sidepanel—Ao configurar para true, as informações de pop-up são apresentadas na guia info do painel lateral, ao invés do mapa.
  • zoom_position—Determina a posição dos botões de controle do zoom. As opções válidas são top-left (padrão), bottom-left, top-right ou bottom-right. Se o parâmetro home estiver configurado para true, o botão de página inicial também moverá de acordo com o valor do parâmetro zoom_position.
  • logoimage—A URL para uma imagem que é utilizada como uma miniatura clicável no layout do mapa. Clicar na miniatura redireciona para a URL configurada com o parâmetro logolink.
  • logolink—URL para um site da web ou recurso da web externo. Clicar na imagem de miniatura configurada com o parâmetro logoimage redireciona para a URL configurada em logolink.

Exemplo de um mapa embutido com um tema escuro, legenda, mostrar painel ao carregar, botões de zoom à direita superior e imagem de logo que é vinculada a uma página da web.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

Exemplo de um mapa embutido com uma legenda, detalhes, detalhes como a guia ativa no painel e pop-ups exibindo no painel lateral na guia info.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

Mapeamento

Os seguintes parâmetros controlam a navegação do mapa e visibilidade dos elementos de mapeamento.

  • webmap—ID de mapa da web a ser exibido dentro do visualizador de mapa embutido, por exemplo, webmap=432a8d7ca22d4b5b859e0bdaa30ae118. O parâmetro webmap é obrigatório.
  • extent—Especifica a extensão a ser utilizada quando o mapa carregar. Isto substitui a extensão padrão do mapa. Somente valores do sistema de coordenadas geográficas são válidos.
  • center—Centraliza o mapa utilizando coordenadas geográficas do mapa (x,y).
  • level—O ID de nível da escala com cache como listado no parâmetro de REST do mapa base. Isto determina o nível de zoom padrão ao carregar o mapa, por exemplo, level=9.
  • zoom—Ao configurar para true, os botões de mais zoom e menos zoom são exibidos. Sua posição no mapa pode ser controlada pelo parâmetro zoom_position.
  • home—Ao configurar para true, o botão de página inicial é exibido. O botão de página inicial é utilizado para voltar para a extensão padrão do mapa. Se extent estiver configurado, o botão de página inicial utilizará esta extensão, ao invés da extensão padrão do mapa. O parâmetro home é somente válido se zoom também estiver configurado para true.
  • scale—Ao configurar para true, a barra de escala é exibida. A barra de escala aparece no canto esquerdo inferior do mapa.
  • disable_scroll—Ao configurar para true, a rolagem do mouse do zoom é desativada. O padrão é true.
  • marker—Posiciona uma imagem desejada como um símbolo de marcador com um pop-up no mapa em uma posição escolhida. A sintaxe é marker=longitude;latitude;wkid;description;URL;title. A latitude e logitude são exigidas; os outros valores são opcionais. A descrição e valores de título precisam ser codificados na URL. Deixe um valor opcional em branco se não desejar inclui-lo. Abaixo está um exemplo:
    marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
  • basemap_toggle—O botão para alternar o mapa base é exibido. Isto deve ser configurado para true para utilizar alt_basemap.
  • alt_basemap—Controla qual mapa base é utilizado como o mapa base alternativo na alternação do mapa base. O parâmetro basemap_toggle deve ser configurado para true a fim de utilizar alt_basemap. Se nenhum mapa base alternativo for especificado, o mapa base de satélite é utilizado. Os valores válidos são streets, satellite, hybrid, topo, gray, oceans, national-geographic, osm, terrain e dark-gray.

Exemplo de um mapa embutido com extensão personalizada, botões de zoom desativados, barra de escala presente, rolagem de zoom do mouse habilitada e galeria de mapa base.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

O exemplo de um mapa embutido com centro, nível de escala de zoom, botão de página inicial e alternar mapa base com um mapa base alternativo.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

Pesquisa de local e feição (pesquisa geográfica)

Os parâmetros seguintes pesquisam e localizam dados no mapa:

  • search—Ao configurar para true, o widget de pesquisa é exibido. Este widget suporta a pesquisa por geocodificação e camadas pesquisáveis. O parâmetro search deve ser configurado como true a fim de utilizar find para camadas pesquisáveis no mapa.
  • searchextent—Ao configurar para true, a pesquisa geográfica pelo widget de pesquisa retorna os resultados que estão dentro da extensão padrão do mapa.
  • find—Abre o mapa em uma posição específica. O parâmetro find pode ser utilizado para procurar por endereços ou lugares (geocodificação) ou para procurar por valores de campo do atributo de uma camada pesquisável. Este parâmetro retorna resultados de todos os recursos de pesquisa que o mapa tem acesso. Se os seus valores da camada pesquisável forem semelhantes aos valores de geocodificação, isto poderá produzir resultados enganosos. Por exemplo, pesquisar por códigos FIPS de cinco dígitos a partir de um campo da camada pesquisável pode ser confuso com ceps dos EUA e retornar múltiplos resultados que não são desejados. Considere utilizar feature para uma pesquisa de feição em vez de find em cenários como este ou quando for necessário um controle dos resultados mais apurado.
  • feature—Permite a pesquisa por uma feição específica em uma camada de feição pesquisável. Encontrar Locais por Camada precisa ser instalado no mapa para um campo pesquisável. A sintaxe é feature=layerID;searchfield;searchvalue, por exemplo, feature=CentralIndianaCities_634;PLACEFIPS;05860.

    A seguinte URL referencia as cidades de Indiana central no exemplo acima e pode ser utilizada para descobrir o ID de camada da camada desejada em seu mapa. Note id:CentralIndianaCities_634 em operationalLayers. Substitua o ID de webmap pelo ID do seu mapa da web para localizar seu ID de camada.

    https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

Exemplo de um mapa embutido que inclui pesquisa, uma extensão de pesquisa e abre para uma posição específica.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

Exemplo de um mapa embutido que abre para uma feição específica.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860