Utilizar parâmetros da URL para criar e modificar mapas

Um mapa criado com o ArcGIS Enterprise contém um mapa base; camadas de dados; uma extensão; uma legenda; e ferramentas de navegação tais como, zoom, mover, encontrar locais e marcadores. Muitos mapas também contêm elementos interativos tais como, uma galeria de mapa base, ferramentas de medição, pop-ups e botões para reproduzir os dados com o passar do tempo.

Além de criar mapas com Map Viewer ou Map Viewer Classic, você pode criar e modificar mapas diretamente com parâmetros da URL.

Por exemplo, você pode construir um mapa com parâmetros da URL que mostra bancos de areia ao longo da costa de Maryland.

myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer&url=https://services5.arcgis.com/9cBkZtsx7PSOoaCF/arcgis/rest/services/Maryland_Shoals/FeatureServer/0

Você pode construir um mapa com parâmetros de URL que mostra fazendas de energia eólica no Reino Unido no Map Viewer Classic.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=https%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

Por exemplo, você pode usar uma URL do visualizador de mapa nas seguintes circunstâncias:

• Caso não seja necessário incluir muitas camadas de referência ou operacionais e aplicar estilos específicos ao conteúdo do mapa, use uma URL para abrir o um dos visualizadores de mapa. Por exemplo, se o seu site permitir que as pessoas procurem um endereço ou visualizem uma única camada relacionada ao seu site, você poderá incluir um link no site que abre o Map Viewer com o mapa base especificado e a única camada exigida.
• Você precisa criar um link para um mapa da web salvo em um site ou e-mail. Você pode usar uma URL que abre o mapa da web específico.

O que incluir na URL

No Map Viewer Classic, a URL sempre começa com a ArcGIS Enterprise URL de página inicial de portal, mais /webmap/viewer.html? e um ou mais dos parâmetros de consulta listados abaixo. No Map Viewer, a URL sempre começa com o nome totalmente qualificado e o adaptador da web do ArcGIS Enterprise ou contexto do balanceador de carga, mais apps/mapviewer/index.html? e um ou mais dos parâmetros de consulta listados abaixo. Para incluir mais de um parâmetro, utilize o sinal gráfico (&) para separar os parâmetros. Você encontrará exemplos de como usar vários parâmetros nesta página.

O primeiro exemplo abaixo abre Map Viewer; o segundo abre Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4

Anotação:

Se algum dos recursos no parâmetro de URL for fornecido como HTTP, a URL do mapa também deve ser HTTP. Para maior segurança, use uma URL HTTPS, se possível.

Codificar os parâmetros da consulta

Todos os parâmetros da consulta devem ser codificados. A codificação da URL garante que caracteres válidos sejam enviados ao portal. A codificação substitui caracteres inválidos com % seguida por seu hex equivalente.

Por exemplo, aqui está um parâmetro da URL não codificado:

basemapUrl=https://myportal.domain.com:7443/arcgis/rest/services/Ocean_Basemap/MapServer

Aqui está o mesmo parâmetro codificado:

basemapUrl=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

Os parâmetros dentro de parâmetros devem também ser codificados, por exemplo:

urls=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttps%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

A internet tem muitos sites e ferramentas gratuitas para gerar URLs codificadas. Para efeitos de leitura, os outros exemplos neste tópico não estão codificados.

Abrir um mapa salvo

Para abrir um mapa salvo criado com Map Viewer ou Map Viewer Classic, utilize webmap= e o ID único do mapa.

No primeiro exemplo, um mapa da web com um ID de 8505192e747d440098523e9e64419710 será aberto no Map Viewer Classic. A segunda URL abre o mesmo mapa no Map Viewer.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8505192e747d440098523e9e64419710

Neste exemplo, um mapa da web com um ID de29990ur6423j1180p53f9t30019491 abrirá noMap Viewer com a extensão definida para -117.996342,33.841078,-117.993692,33.844375:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375

Definir o mapa base

Para definir o mapa base, configure basemapUrl= para a camada. Se um mapa base não for definido, o mapa base padrão, Topográfico Mundial, será usado.

No primeiro exemplo de URL, o Map Viewer abre com o mapa físico mundial usado como mapa base. A segunda URL de exemplo abre no Map Viewer Classic.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

Neste exemplo, o Map Viewer abre com o mapa físico Mundial usado como mapa base e uma camada operacional com o ID do item d35a5w4bo77593y0358s0x7312jpp04 presente no mapa:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=d35a5w4bo77593y0358s0x7312jpp04

Incluir uma camada de referência

Para incluir uma camada de referência com o mapa base, configure basemapReferenceUrl= para a camada. O parâmetro basemapReferenceUrl= deve ser utilizado além do parâmetro basemapUrl.

Neste exemplo, o Map Viewer Classic abre com a camada de imagem do mapa de imagens do mundo presente e o mapa de base definido como Limite do mundo e camada de locais:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

Definir as camadas operacionais

Para definir as camadas operacionais que sobrepõem o mapa base, utilize webmap=, layers=, layerIds=, url= ou urls=. Se a camada for um item no site da web, utilize layers= de forma que você obtenha todas as configurações da camada. Para adicionar subcamadas individuais de uma camada de feição que contém várias subcamadas, use layerIds=. Se a camada não estiver no site da web, utilize url= ou urls=.

O parâmetro layers= aceita o ID de um único item ou IDs de múltiplos itens. Para múltiplas camadas, utilize uma lista de IDs separados por vírgulas (&layers=<itemID>,<itemID>,<itemID>).

O primeiro exemplo abre no Map Viewer. O segundo abre no Map Viewer Classic.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

O parâmetro layerIds= aceita o ID de única camada ou IDs de múltiplas camadas. Se uma camada de feição tiver várias subcamadas, use o parâmetro layerIds= para adicionar subcamadas individuais. Para múltiplas camadas, utilize uma lista de IDs separados por vírgulas (&layerIds=0,1,2).

O primeiro exemplo abre no Map Viewer. O segundo abre no Map Viewer Classic.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2
https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

O parâmetrourl= aceita uma única URL da camada.

Por exemplo:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

Utilize urls= para incluir mais de uma camada. Separe as camadas com uma vírgula. A extensão do mapa é baseada na última camada na lista ou no mais lento para carregar. Para ampliar uma extensão específica, inclua o parâmetro extent=.

A primeira URL abre o mapa no Map Viewer. A segunda URL abre no Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

A partir do ArcGIS 10.5, você pode utilizar a operação ?layers em um serviço de feição.

Por exemplo:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

Definir o nível de escala e centralizar o mapa

A escala é automaticamente configurado para um mapa no Map Viewer Classic quando você utilizar o webmap ou parâmetro find. Se você utilizar o parâmetro webmap, o mapa é automaticamente ampliado para na extensão total do mapa, a menos que outros parâmetros da URL, tais como, level e center ou extent são utilizados para substituir a escala do mapa da web. Se você utilizar o parâmetro find, o mapa é automaticamente ampliado na melhor extensão do local encontrado.

Para definir o nível de escala específico, utilize os parâmetros center e level. O parâmetro level aceita o ID de nível da escala de cache como listado no ponto final do serviço REST do mapa base de mosaico. A resolução é inversamente relativa à escala. O parâmetro level é somente suportado para mapas base mosaicado, não para mapas base criado a partir de serviços de mapa dinâmicos e outros dados mosaicados.

Para centralizar o mapa em uma posição em particular, configure center utilizando coordenadas geográficas (x,y) ou coordenadas planas (x,y,WKID). Você pode utilizar vírgulas ou pontos-e-vírgulas como separadores. Utilize pontos-e-vírgulas se os seus números utilizarem vírgulas como seus decimais.

Anotação:

Os parâmetros level e center devem ser utilizados juntos. O parâmetro level é ignorado se for utilizado sozinho.

Exemplo de coordenadas geográficas no Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4

Exemplo de coordenadas geográficas no Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

Exemplo de coordenadas planas no Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=500000,5500000,102100&level=4

Definir a extensão

Para definir a extensão de mapa, utilize extent. O parâmetro extent aceita coordenadas geográficas (GCS) como MinX,MinY,MaxX,MaxY ou coordenadas planas (PCS) como MinX,MinY,MaxX,MaxY,WKID. Você pode utilizar vírgulas ou pontos-e-vírgulas como separadores. Utilize pontos-e-vírgulas se os seus números utilizarem vírgulas como seus decimais.

Exemplo de coordenadas geográficas no Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Exemplo de coordenadas planas no Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Exemplo de coordenadas planas no Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Configurar a visibilidade da camada

Para definir a visibilidade das subcamadas para uma camada que você abre no mapa, use layers=show:.

Neste exemplo, as subcamadas 1 e 2 na camada Parcels são visíveisno Map Viewer Classic, mas outras subcamadas não são visíveis:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://otherportal.domain.com:7443/arcgis/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

Encontrar um local ou feição para abrir o mapa

Para encontrar um local ou feição imediatamente após abrir o mapa, use find. O mapa é automaticamente ampliado até o correspondente mais próximo e um marcador de texto é adicionado ao mapa. O parâmetro find aceita endereços de única linha, endereços parciais (como somente cidade ou somente país), nomes de lugares e coordenadas de latitude-longitude.

O seguinte exemplo utiliza um endereço de linha única no Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?find=380 new york st,redlands,ca

Dica:

Para encontrar um local ou feição em uma camada pesquisável, inclua o parâmetro webmap= com o ID único do mapa.

Adicionar um ponto

Para adicionar um ponto no mapa, utilize marker=<x>,<y>. Você também pode incluir as seguintes propriedades opcionais:

• <wkid>—Referência espacial das coordenadas x,y a serem adicionadas no mapa. Se você não incluir um WKID, coordenadas GCS serão utilizadas.
• <encoded title>—Título de pop-up do ponto. Se você não incluir um título, o pop-up estará vazio.
• <encoded icon URL>—Símbolo para o ponto. Se você não incluir um símbolo, um símbolo de marcador azul será utilizado.
• <encoded label>—Rótulo próximo ao símbolo de ponto.

Exemplo

O exemplo seguinte utiliza separadores de ponto-e-vírgula:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Considerações

Tenha em mente o seguinte ao adicionar um ponto no mapa:

• No Map Viewer Classic, o ponto é adicionado a uma nova camada de notas do mapa no local especificado das coordenadas x, y.
• As coordenadas <x>,<y> são necessárias para adicionar um ponto.
• Certifique-se de codificar os parâmetros title, icon e label.
• Você deve adicionar propriedades nesta ordem: marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
• Você pode utilizar vírgulas ou pontos-e-vírgulas como separadores. Utilize pontos-e-vírgulas se os seus números utilizarem vírgulas como seus decimais.
• Utilize valores vazios. Não utilize espaços. Por exemplo, para especificar um rótulo e nenhuma das outras propriedades opcionais, adicione o rótulo como o sexto parâmetro com valores vazios para os outros (x;y;;;;label).
• Se você desejar o mapa ampliado (além de centralizar no ponto), inclua o parâmetro level.
• Você pode editar e salvar a camada de anotações do mapa como um mapa ou item.
• As contas organizacionais podem utilizar o ponto para obter direções e executar análise.

Painel Ocultar os Detalhes

Anotação:

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

Para ocultar o painel Detalhes no Map Viewer Classic, use mapOnly=true.

Neste exemplo, um mapa da web salvo com ID b487d81007294fb5a0be9e10a411f2d0 é aberto noMap Viewer Classic, mas o painel Detalhes está oculto:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true