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 de URL que mostre biomas e ecoregiões.
myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer&url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/Resolve_Ecoregions/FeatureServerVocê 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.5381Por 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/apps/mapviewer/index.html?center=20,45&level=8
https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=8Anotaçã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/World_Ocean_Base/MapServer
Aqui está o mesmo parâmetro codificado:basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean%2FWorld_Ocean_Base%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 75a3ce8990674a5ebd5b9ab66bdab893 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=75a3ce8990674a5ebd5b9ab66bdab893
https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893Neste 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.844375Definir 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://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce
https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServerNeste exemplo, o Map Viewer abre com o mapa físico Mundo usado como mapa base e uma camada operacional com ID de item 9e2f2b544c954fda9cd13b7f3e6eebce 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=9e2f2b544c954fda9cd13b7f3e6eebceIncluir 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, Map Viewer Classic abre com a camada de mapa base World Imagery e a camada de referência definida para a camada Lugares e Limites do Mundo:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?
?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServerDefinir 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?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3
https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3O 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,2O parâmetrourl= aceita uma única URL da camada.
Veja os seguintes exemplos:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?
url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServerUtilize 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://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4&extent=-108,40,-85,31
https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4A partir do ArcGIS 10.5, você pode utilizar a operação ?layers em um serviço de feição. Veja os seguintes exemplos: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. Use ponto e vírgula se os seus números usarem 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.
Veja o seguinte exemplo de coordenadas geográficas no Map Viewer:
https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4Veja o seguinte exemplo de coordenadas geográficas no Map Viewer Classic:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4Veja o seguinte exemplo de coordenadas planas no Map Viewer:
https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=500000,5500000,102100&level=4Definir 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. Use ponto e vírgula se os seus números usarem vírgulas como seus decimais.
Veja o seguinte 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.06Veja o seguinte 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,102113Veja o seguinte 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,102113Configurar a visibilidade da camada
Para definir a visibilidade das subcamadas para uma camada que você abre no mapa, use layers=show:.
Neste exemplo, a subcamada 3 é visível, mas outras subcamadas não são visíveis:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=PennsylvaniaEncontrar 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,caDica:
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=7Consideraçõ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.
- Você deve 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. Use ponto e vírgula se os seus números usarem 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