Os parâmetros da URL para modificar mapas

Um mapa criado com o visualizador de mapa 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 mapas base que permite a você trocar entre mapas como imagem e ruas, mais ferramentas de medição, janelas pop-up que exibem atributos sobre uma feição específica e botões para executar os dados com o passar do tempo.

Como uma alternativa para criar mapas com o visualizador de mapa, você pode criar ou 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 dentro do 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 quaisquer um dos recursos no parâmetro da URL forem fornecidos como HTTP, a URL para o mapa também deverá ser HTTP. Para segurança adicional, você deve utilizar 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 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 o visualizador de mapa, 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 visualizador de mapa, 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 visualizador de mapa, utilize mapOnly=true.

Por exemplo:

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