Um mapa criado com o Map Viewer ou Map Viewer Classic contém um mapa base; camadas de dados; uma extensão; Uma legenda; e ferramentas de navegação, como zoom, mover, localizadores delugares 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.
https://www.arcgis.com/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/FeatureServerVisualize este exemplo no Map Viewer
Por exemplo, você pode usar uma URL do Map Viewer 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 Map Viewer. Por exemplo, se o seu site permitir que usuários 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
A URL sempre começa com https://www.arcgis.com/apps/mapviewer/index.html? no Map Viewer e https://www.arcgis.com/home/webmap/viewer.html? no Map Viewer Classic e inclui 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.
Veja os seguintes exemplos:
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=8Visualize este exemplo no Map Viewer
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.
Codificar os parâmetros da consulta
Todos os parâmetros da consulta devem ser codificados. A codificação de URL garante que os caracteres válidos sejam enviados para o ArcGIS Online. 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://services.arcgisonline.com/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%2Fmaps.ngdc.noaa.gov%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—por exemplo, https://www.urlencoder.io/. Para efeitos de leitura, os outros exemplos neste tópico não estão codificados. Clique no link Visualizar este exemplo no Map Viewer após o exemplo para visualizar a URL codificada em um navegador da web.
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.
Neste exemplo, um mapa da web com um ID de 75a3ce8990674a5ebd5b9ab66bdab893 será aberto noMap Viewer:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893Visualize este exemplo no Map Viewer
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://www.arcgis.com/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.
Neste exemplo, Map Viewer abre com OpenStreetMap usado como mapa base:
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebceVisualize este exemplo no Map Viewer
Neste 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://www.arcgis.com/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 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://www.arcgis.com/apps/mapviewer/index.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/MapServerVisualize este exemplo no Map Viewer
Neste exemplo, o Map Viewer abre com a camada de imagem do mapa de imagens do mundo presente e o mapa base definido como a camada de mapa base de imagens do mundo:
https://www.arcgis.com/apps/mapviewer/index.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/MapServer&layers=df610ec7afe74b1995a913ec1fc1284eDefinir 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>).
Veja os seguintes exemplos:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3Visualize este exemplo no Map Viewer
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).
Veja os seguintes exemplos:
https://www.arcgis.com/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2Visualize este exemplo no Map Viewer
O parâmetrourl= aceita uma única URL da camada.
Veja os seguintes exemplos:
https://www.arcgis.com/apps/mapviewer/index.html?url=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/USGS_Seismic_Data_v1/FeatureServerVisualize este exemplo no Map Viewer
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=.
Veja os seguintes exemplos:
https://www.arcgis.com/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,31Definir 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:
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=4Visualize este exemplo no Map Viewer
Veja o seguinte exemplo de coordenadas planas:
https://www.arcgis.com/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:
https://www.arcgis.com/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06Visualize este exemplo no Map Viewer
Veja o seguinte exemplo de coordenadas planas:
https://www.arcgis.com/apps/mapviewer/index.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:
Anotação:
A numeração da subcamada começa com zero (0), conforme mostrado no parâmetro REST.https://www.arcgis.com/apps/mapviewer/index.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, coordenadas de latitude-longitude, e feições em camadas pesquisáveis (como 1916352001 para um Número de Identificação do Lote (PIN)).
O seguinte exemplo utiliza um endereço de linha única:
https://www.arcgis.com/apps/mapviewer/index.html?find=380 new york st,redlands,caVisualize este exemplo no Map Viewer
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://www.arcgis.com/apps/mapviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra MarathonConsideraçõ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. Ele estará disponível em uma versão futura do Map Viewer.
Para ocultar o painel Detalhes no Map Viewer Classic, use mapOnly=true.
Neste exemplo, um mapa da web salvo com ID 8505192e747d440098523e9e64419710 é aberto no Map Viewer Classic, mas o painel Detalhes está oculto:
https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true