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 inicia com a Portal for ArcGIS página inicial, 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 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 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 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 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
Centralizar mapa
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.
Exemplo de coordenadas geográficas:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45
Exemplo de coordenadas planas:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100
Definir nível de escala
Para definir o nível de escala do Map Viewer, utilize os parâmetros center e level=. O parâmetro level aceita o ID do nível de escala do cache como listado no parâmetro do serviço REST. O nível de escala do cache pode ser determinado utilizando a informação no parâmetro do serviço REST do mapa. A resolução é inversamente relativa à escala.
A escala é automaticamente configurada quando você utiliza o parâmetro webmap ou find; level é ignorado. Se você utilizar o parâmetro webmap, o mapa é automaticamente ampliado na extensão total do mapa. Se você utilizar o parâmetro find, o mapa é automaticamente ampliado na melhor extensão do local encontrado.
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 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 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
Encontrar local 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 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
- <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 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