Utilizar parâmetros da URL para modificar mapas

Um mapa criado com o Map Viewer 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.

Como uma alternativa para criar mapas com Map Viewer, você pode criar e modificar mapas diretamente com parâmetros da URL.

Por exemplo, aqui está como você pode construir um mapa com parâmetros da URL que mostram fazendas de energia eólica no Reino Unido.

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

O que incluir na URL

A URL sempre começa com a página inicial do ArcGIS Enterprise , mais /webmap/viewer.html? e um ou mais dos parâmetros de consulta listados abaixo. Para incluir mais de um parâmetro, utilize (&) para separar os parâmetros.

Por exemplo:

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

Anotação:

Se nenhum dos recursos no parâmetro da URL forem fornecidos como HTTP, a URL do mapa deve ser HTTP também. Para segurança adicional, você deve utilizar uma URL de 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 para o site da web do 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=http%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%2Chttp%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

A web 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, utilize webmap= e o ID único do mapa.

Por exemplo:

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

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 será o mapa base Topográfico Mundial.

Por exemplo:

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

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.

Por exemplo:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=http://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=, 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. 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>).

Por exemplo:

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

O parâmetro url= 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=.

Por exemplo:

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 o ?layers operation on a feature service.

Por exemplo:

http://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 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:

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

Exemplo de coordenadas planas:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100&level=4

Definir a extensão

Para definir a extensão do mapa, utilize extent para definir a extensão do mapa. 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:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

Exemplo de coordenadas planas:

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 camadas no mapa, utilize layers=show:.

Por exemplo:

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

Encontre uma localização ou feição para abrir o mapa

Para encontrar um local ou feição que seja utilizada para abrir o mapa, utilize 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 cidade ou país somente), nomes de lugares e coordenadas de latitude-longitude.

O exemplo seguinte utiliza um endereço de linha única.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?find=380 new york st,redlands,ca

Adicionar um ponto

Para adicionar um ponto no mapa, utilize marker=<x>,<y>. O ponto é adicionado em uma nova camada de anotações do mapa na posição x.y especificada. Você também pode incluir as seguintes propriedades opcionais:

• <wkid>—Referência espacial das coordenadas x,y 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.

Considerações

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

• <x>,<y> são exigidos.
• 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, se você desejar 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.

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

Painel Ocultar os Detalhes

Para ocultar o painel Detalhes do Map Viewer, utilize mapOnly=true.

Por exemplo:

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