O que a sobreposição Identity faz
Identity é uma sobreposição vetorial. Você entrega duas camadas. A camada de entrada contém as feições que você quer manter, por exemplo lotes, estradas ou poços. A camada Identity contém polígonos com atributos, por exemplo zonas de inundação, zoneamentos ou tipos de solo. A ferramenta faz dois trabalhos ao mesmo tempo. Onde uma feição de entrada se sobrepõe a um polígono Identity, ela recorta essa parte e copia nela os atributos do polígono. Onde a feição de entrada não se sobrepõe a nada, ela mantém essa parte e deixa vazios os campos Identity.
O resultado sempre cobre a camada de entrada inteira. Nenhuma área, nenhum comprimento de linha e nenhum ponto se perde. Essa é a grande diferença para o Intersect (descarta tudo que fica fora da sobreposição) e para o Union (adiciona também os polígonos Identity que não tocam nenhuma entrada). Cada parte de saída leva todos os atributos da sua feição de entrada. As partes dentro de um polígono Identity levam também os atributos desse polígono. Em fórmula: Identity(A, B) = Intersect(A, B) + Erase(A, B). É a mesma regra da ferramenta Identity do ArcGIS Pro e do antigo ARC/INFO.
Criei esta ferramenta porque «divida meus lotes por zona e mantenha as duas tabelas de atributos» é uma tarefa diária, e a resposta de sempre é um SIG de mesa com a licença certa. Solte no mapa um Shapefile compactado em ZIP, GeoJSON, KML, KMZ, GPX ou WKT, ou desenhe suas próprias formas. Escolha a camada de entrada e a camada Identity, clique em Executar Identity e baixe o resultado. Todo o cálculo geométrico acontece no seu navegador, então seus arquivos ficam no seu computador. O mapa começa sem mapa base para ficar rápido, e você pode ativar um mapa de ruas ou de satélite quando quiser.
Identity, Union, Intersect, Erase e Spatial Join: qual você precisa?
As ferramentas de sobreposição são fáceis de confundir porque todas combinam duas camadas. A diferença está na geometria que mantêm e nos atributos que acabam na saída. Esta tabela as coloca lado a lado para uma camada de entrada A e uma camada de sobreposição B.
| Ferramenta | Geometria mantida | Atributos na saída |
|---|---|---|
| Identity (esta ferramenta) | Todo o A, cortado por B | A em todo lugar, mais B onde se sobrepõem, campos de B vazios no resto |
| Union | Todo o A e todo o B, cortados onde se sobrepõem | A e B onde se sobrepõem, só um lado no resto |
| Intersect | Só a parte em que A e B se sobrepõem | A e B juntos |
| Erase | As partes de A fora de B | Só A |
| Clip | As partes de A dentro de B | Só A |
| Diferença simétrica | As partes de A fora de B e as partes de B fora de A | A e B, cada um nas suas partes |
| Spatial Join | A sem mudança, sem cortes | A mais os atributos da feição de B encontrada pela posição |
Um jeito rápido de escolher: se você precisa manter toda a entrada e ainda saber em que zona, distrito ou classe cai cada parte, use Identity. Se só a sobreposição importa, use Intersect. Se você não quer que suas feições sejam cortadas, use uma junção espacial.
Outros nomes da sobreposição Identity
A mesma operação tem nomes diferentes em cada programa, e as pessoas procuram por todos. Veja para onde cada nome aponta.
| Nome que você conhece | Onde você o vê | O que significa |
|---|---|---|
| Identity | ArcGIS Pro, ArcMap, arcpy | O nome original. Caixa Analysis > Overlay > Identity, e arcpy.analysis.Identity. |
| Overlay com how="identity" | GeoPandas | geopandas.overlay(df1, df2, how="identity") devolve as mesmas partes e os mesmos campos. |
| Interseção + Diferença, mescladas | QGIS | O QGIS não tem uma ferramenta chamada Identity. Execute Interseção e Diferença e depois mescle as duas saídas. |
| Union, depois remover as partes só do Identity | QGIS, ArcGIS | O Union mantém também os polígonos que só existem em B. Remova-os e você obtém um resultado Identity. |
| st_intersection + st_difference | R (pacote sf) | As duas metades de um Identity, juntadas com rbind. |
| ST_Intersection + ST_Difference | PostGIS | As mesmas duas metades em SQL, unidas com UNION ALL. |
| Sobreposição vetorial, sobreposição de polígonos, análise de sobreposição | Livros de SIG | O assunto geral. Identity é uma das operações padrão de sobreposição, ao lado de union, intersect, erase e clip. |
| Transferência de atributos por sobreposição, marcação de zonas | Planejamento e trabalho ambiental | Nomes simples para o uso do Identity: marcar cada parte de uma feição com a zona em que ela está. |
Se você procurava «como divido um shapefile com outro shapefile e mantenho as duas tabelas de atributos», esta é a ferramenta.
Formatos de arquivo compatíveis
Você pode carregar vários arquivos de uma vez e misturar formatos. Cada arquivo vira uma camada própria no painel Camadas. Uma camada de entrada pode conter pontos, linhas e polígonos juntos, e cada um é tratado com o método certo.
Formatos de entrada (o que você pode enviar)
| Formato | Extensão | Observações |
|---|---|---|
| GeoJSON | .geojson, .json | Uma FeatureCollection, um Feature único ou uma geometria solta. Uma GeometryCollection é dividida em suas partes. |
| Esri Shapefile | .zip | Compacte juntos os arquivos .shp, .shx e .dbf. Adicione o arquivo .prj e os dados projetados são convertidos para WGS84 ao carregar. Um arquivo .cpg define a codificação do texto. |
| KML | .kml | Marcadores do Google Earth. MultiGeometry é dividida em suas partes, e ExtendedData vira atributos. |
| KMZ | .kmz | Um arquivo KML compactado. O primeiro arquivo .kml do pacote é lido. |
| GPX | .gpx | Arquivos de GPS. Waypoints viram pontos, e trilhas e rotas viram linhas. Os valores de elevação são mantidos. |
| WKT | .wkt, .txt | Well-Known Text. Uma geometria para o arquivo todo, ou uma geometria por linha. |
Formatos de saída (o que você pode baixar)
| Formato | Extensão | Observações |
|---|---|---|
| GeoJSON | .geojson | O formato web padrão (RFC 7946) em WGS84. Mantém cada atributo e seu tipo. Abre no ArcGIS Pro, no QGIS e em quase toda biblioteca de mapas web. |
| KML | .kml | Abre no Google Earth. Os atributos são gravados como ExtendedData em cada marcador. |
| CSV (WKT) | .csv | Uma linha por feição. A primeira coluna guarda a geometria em WKT, e cada atributo tem sua própria coluna. Abre no Excel, e o QGIS consegue ler a coluna WKT como geometria. |
Cada arquivo pode ter até 50 MB. Para conjuntos de dados nacionais muito grandes, um SIG de mesa ainda é a melhor escolha. Veja a comparação mais abaixo nesta página.
Detalhes técnicos
Aqui está exatamente o que a ferramenta faz com seus dados. Se você conhece o Identity do ArcGIS Pro, quase tudo vai parecer familiar.
- Tipos de geometria de entrada
- Point, MultiPoint, LineString, MultiLineString, Polygon e MultiPolygon. Uma camada pode misturar todos.
- Tipos de geometria da camada Identity
- Polygon e MultiPolygon, com ou sem buracos. Uma camada sem polígonos não pode ser escolhida como camada Identity.
- Vários polígonos Identity
- A camada Identity não é mesclada. Cada polígono mantém seus próprios atributos. Onde dois polígonos Identity se sobrepõem, a entrada é cortada uma vez para cada um, então a sobreposição aparece duas vezes, uma com cada conjunto de atributos. É assim que o Identity do ArcGIS funciona.
- Atributos
- Cada atributo da feição de entrada é copiado para cada parte de saída. Os atributos do polígono Identity são adicionados como campos novos. As partes que ficam fora de todos os polígonos Identity recebem valores vazios (null) nesses campos.
- Conflitos de nomes de campos
- Se um campo Identity tem o mesmo nome de um campo de entrada, o campo de entrada mantém o nome e o campo Identity ganha um sufixo:
nameviraname_1, depoisname_2, e assim por diante. A caixa de resultados lista cada campo renomeado. - Campos de rastreamento
- Como opção, a ferramenta adiciona
FID_input(a posição da feição de entrada, começando em 0),FID_identity(a posição do polígono Identity, ou -1 quando não há nenhum),identity_status(overlap ou input_only) eidentity_area_m2,identity_length_mouidentity_pointspara cada parte. - Sistema de coordenadas
- Longitude e latitude WGS84 (EPSG:4326), igual ao GeoJSON. Um Shapefile em ZIP com arquivo .prj é convertido para WGS84 ao carregar.
- Modelo geométrico
- O corte é feito em um plano em graus, o mesmo modelo usado pelo Turf.js e pela maioria das bibliotecas SIG web. As áreas e os comprimentos no painel de resultados são medidos na esfera (geodésicos), em metros quadrados e metros.
- Regra da borda
- A borda de um polígono Identity conta como dentro. Um ponto exatamente na borda recebe os atributos desse polígono, e o mesmo vale para um trecho de linha que corre pela borda. Um polígono que só toca a borda por fora não é cortado.
- Saída multiparte
- Se uma sobreposição corta uma feição em várias partes com os mesmos atributos, as partes ficam juntas como uma feição multiparte (MultiLineString, MultiPolygon ou MultiPoint). Marque «Dividir resultados multiparte» para obter uma feição por parte.
- Geometria inválida
- Se o cálculo geométrico falha para uma feição de entrada, essa feição é ignorada e contada, e o resto da camada é processado normalmente.
- Privacidade
- Tudo roda no seu navegador. Nenhum arquivo e nenhuma geometria é enviado a um servidor.
Como usar a ferramenta Identity, passo a passo
Aqui está todo o fluxo com os dados de exemplo incluídos: uma camada de cidade com lotes, estradas e pontos, e três polígonos de zonas de inundação com nome da zona, nível de risco e profundidade da inundação. Seus próprios arquivos funcionam do mesmo jeito.

O mapa abre vazio e sem mapa base, então nada é carregado sem necessidade. A barra de ferramentas tem as ferramentas de desenho Ponto, Linha, Polígono e Retângulo Identity, um botão Enviar e um botão Dados de exemplo.

Arraste e solte seus arquivos no mapa, ou clique em Enviar. Aqui cliquei em Dados de exemplo. Isso adiciona uma camada de cidade com lotes, estradas e pontos, e uma camada de zonas de inundação com um canal de cheia, uma bacia de retenção e um vertedor que se sobrepõem.

No painel Identity, escolha a camada de entrada (os dados mantidos por inteiro) e a camada Identity (os polígonos que dão seus atributos). Só camadas com polígonos aparecem na lista Identity. Decida se quer os campos de rastreamento e se os resultados multiparte devem ser divididos.

O resultado aparece como uma camada nova, e a camada de entrada fica oculta. Cada lote, estrada e ponto continua lá, mas lotes e estradas agora estão cortados ao longo das bordas das zonas. A caixa de resultados mostra quantas feições de entrada se sobrepõem a uma zona, quantas não, e a área, o comprimento e os pontos com e sem atributos Identity.

Marque «Mostrar mapa base» para ver o resultado em um mapa de ruas ou de satélite. Clique em uma parte dentro de uma zona para abrir seus atributos. Você vê os campos do lote e os campos da zona em uma única tabela. Uma parte fora de todas as zonas mostra campos de zona vazios.

No painel Exportar, escolha a camada e baixe em GeoJSON, KML ou CSV com uma coluna WKT. A setinha ao lado de cada camada no painel Camadas é um download rápido em GeoJSON.
Como fazer uma sobreposição Identity em um SIG
Nem todo SIG tem uma ferramenta com esse nome. O ArcGIS a chama de Identity, o GeoPandas usa overlay com how="identity", e o QGIS precisa de duas ferramentas. Veja como fazer nesta ferramenta, no ArcGIS Pro, no ArcMap e no QGIS, e como automatizar com script.
Nesta ferramenta
Carregue a camada que você quer manter e os polígonos que dão os atributos. Escolha a primeira como camada de entrada e a segunda como camada Identity, e clique em Executar Identity. Pontos, linhas e polígonos da mesma camada de entrada são processados em uma só execução. Se você só precisa marcar feições com uma área retangular, clique em Retângulo Identity e depois em dois cantos opostos do mapa.
No ArcGIS Pro
Abra o painel Geoprocessamento e procure Identity. Ele fica na caixa Analysis, em Overlay. Defina Input Features e Identity Features, escolha uma saída e a opção Join Attributes: All dá os campos FID e todos os atributos, Without FIDs omite os campos FID, e Only FIDs mantém só os IDs. Clique em Run. Veja a página da ferramenta para saber qual nível de licença sua versão exige.
No ArcMap
No ArcMap a ferramenta fica em ArcToolbox > Analysis Tools > Overlay > Identity, e exige uma licença Advanced (ArcInfo). Os parâmetros são os mesmos do ArcGIS Pro. A Esri aposentou o ArcMap em março de 2026, então para trabalhos novos recomendo o ArcGIS Pro, o QGIS ou esta ferramenta. Scripts antigos que chamam Identity_analysis passam para o ArcGIS Pro com pequenas mudanças.
No QGIS
O QGIS não tem uma ferramenta chamada Identity, mas você pode montá-la em três passos. Execute Vetor > Ferramentas de geoprocessamento > Interseção (camada de entrada e camada de sobreposição) para obter as partes sobrepostas com os dois conjuntos de atributos. Execute Vetor > Ferramentas de geoprocessamento > Diferença para obter as partes da entrada sem sobreposição. Depois use Vetor > Ferramentas de gerenciamento de dados > Mesclar camadas vetoriais para juntar as duas saídas. A camada Diferença não tem campos da sobreposição, então eles ficam vazios após a mescla.
Com arcpy (Python para ArcGIS)
No ArcGIS Pro a função é arcpy.analysis.Identity(in_features, identity_features, out_feature_class, join_attributes, cluster_tolerance, relationship). Scripts antigos do ArcMap usam arcpy.Identity_analysis. O código abaixo mostra essa forma, e o mesmo trabalho em PyQGIS, GeoPandas e PostGIS.
A mesma sobreposição Identity em código
Se você marca as mesmas camadas toda semana, um script economiza tempo. Todos estes exemplos dividem uma camada de lotes por zonas de inundação e mantêm os atributos de ambas.
import arcpy
arcpy.env.workspace = r"C:\data\city.gdb"
# ArcGIS Pro: Analysis toolbox > Overlay > Identity
# join_attributes: "ALL" (default), "NO_FID" or "ONLY_FID"
arcpy.analysis.Identity("parcels", "flood_zones", "parcels_zoned", "ALL")
# Older ArcMap syntax (same tool, old name)
arcpy.Identity_analysis("parcels", "flood_zones", "parcels_zoned")# QGIS has no Identity tool: Intersection + Difference, then merge
inter = processing.run("native:intersection", {
"INPUT": "C:/data/parcels.shp",
"OVERLAY": "C:/data/flood_zones.shp",
"OUTPUT": "memory:",
})["OUTPUT"]
diff = processing.run("native:difference", {
"INPUT": "C:/data/parcels.shp",
"OVERLAY": "C:/data/flood_zones.shp",
"OUTPUT": "memory:",
})["OUTPUT"]
processing.run("native:mergevectorlayers", {
"LAYERS": [inter, diff],
"OUTPUT": "C:/data/parcels_zoned.gpkg",
})# GeoPandas
import geopandas as gpd
parcels = gpd.read_file("parcels.shp")
flood = gpd.read_file("flood_zones.shp").to_crs(parcels.crs)
parcels_zoned = gpd.overlay(parcels, flood, how="identity")
parcels_zoned.to_file("parcels_zoned.gpkg")
-- PostGIS
SELECT p.parcel_id, p.land_use, z.zone, z.risk, ST_Intersection(p.geom, z.geom) AS geom
FROM parcels p
JOIN flood_zones z ON ST_Intersects(p.geom, z.geom) AND NOT ST_Touches(p.geom, z.geom)
UNION ALL
SELECT parcel_id, land_use, NULL, NULL, geom FROM (
SELECT p.parcel_id, p.land_use,
ST_Difference(p.geom, COALESCE(
(SELECT ST_Union(z.geom) FROM flood_zones z WHERE ST_Intersects(p.geom, z.geom)),
ST_GeomFromText('POLYGON EMPTY', 4326))) AS geom
FROM parcels p
) rest
WHERE NOT ST_IsEmpty(geom);Minha opinião: para uma sobreposição pontual em um arquivo de tamanho normal, esta ferramenta é o caminho mais rápido do arquivo ao resultado. No GeoPandas, overlay(how="identity") é o script mais curto. No ArcGIS Pro, use a ferramenta Identity e deixe os campos FID ligados, porque eles facilitam rastrear cada parte até a origem.
Como a ferramenta funciona, passo a passo
Este é o caminho dos seus dados a partir do clique em Executar Identity. Cada passo roda no seu navegador.
- Ler e limpar a entrada. Cada arquivo vira feições GeoJSON em WGS84. Uma GeometryCollection é dividida em feições separadas com os mesmos atributos, de modo que o motor só vê tipos de geometria simples.
- Preparar os polígonos Identity. Cada polígono Identity continua como uma feição própria, com seus atributos e sua própria caixa delimitadora. Nada é mesclado nem dissolvido. A ferramenta também lê os nomes dos atributos das duas camadas e decide os nomes dos campos de saída, renomeando qualquer campo Identity que entre em conflito com um campo de entrada.
- Achar os polígonos Identity próximos. Para cada feição de entrada, a ferramenta compara sua caixa delimitadora com a de cada polígono Identity. Só os polígonos cujas caixas se tocam seguem para o cálculo detalhado. Uma feição de entrada sem nenhum desses polígonos é copiada de imediato para a saída com os campos Identity vazios.
- Cortar pontos. Cada ponto é testado com um teste de ponto em polígono contra cada polígono Identity próximo. Um ponto dentro de um polígono (ou na sua borda) vira um ponto de saída para esse polígono, com seus atributos. Um ponto em nenhum polígono é mantido com os campos Identity vazios.
- Cortar linhas. Cada segmento de linha é testado contra as arestas de cada polígono próximo. A ferramenta acha cada lugar em que o segmento cruza uma aresta, corta ali e testa o meio de cada pedaço pequeno. Os pedaços dentro de um polígono vão para esse polígono. Os pedaços fora de todos os polígonos próximos são encadeados de volta em linhas e mantidos com os campos Identity vazios.
- Cortar polígonos. Cada polígono de entrada é intersectado com cada polígono Identity próximo por uma operação booleana de linha de varredura (Martinez-Rueda). Cada resultado não vazio é uma parte sobreposta com os atributos desse polígono. Depois, o polígono de entrada menos todos os polígonos Identity próximos dá a parte restante com os campos Identity vazios.
- Copiar atributos e adicionar campos. Cada feição de saída recebe uma cópia de todos os atributos da sua feição de entrada, depois os campos Identity (valores reais ou null), depois os campos de rastreamento opcionais. Se você marcou a opção multiparte, os resultados multiparte são divididos aqui em partes simples.
- Relatar e desenhar. A ferramenta conta as feições de entrada com e sem correspondência, soma a área, o comprimento e os pontos com e sem atributos Identity, lista os campos novos e desenha o resultado como uma camada nova. A camada de entrada fica oculta para você ver bem o resultado.
O código das linhas é compartilhado com as ferramentas Clip e Erase deste site. O Clip mantém os pedaços cujo meio está dentro da máscara, o Erase mantém os pedaços cujo meio está fora, e o Identity faz os dois, uma passada por polígono Identity mais uma passada para o resto.
A teoria e a matemática da sobreposição Identity
O Identity é construído com duas operações básicas de conjuntos sobre geometrias. Aqui está a matemática, da regra de conjuntos aos algoritmos, à história e às medidas.
1. Identity como interseção mais diferença
Seja A a camada de entrada e B a camada Identity, com os polígonos B1 a Bk. Cada feição de entrada a é substituída pela sua sobreposição com cada Bj, mais a parte de a que fica fora de todos. Os atributos de a vão em cada parte. Os atributos de Bj vão só na parte a ∩ Bj.
Identity(A, B) = Intersect(A, B) ∪ Erase(A, B) para cada a em A: partes sobrepostas a ∩ Bj (uma por Bj com a ∩ Bj ≠ ∅) campos: a + Bj parte restante a ∖ (B1 ∪ … ∪ Bk) (se não for vazia) campos: a + null
O conjunto de partes sempre cobre a por completo. Se os polígonos Identity não se sobrepõem entre si, as partes também não se sobrepõem, e somam exatamente a.
2. Um exemplo resolvido
Pegue um lote P de x = 2 a 10 e y = 0 a 5 (área 40). A zona Z1 cobre x = 0 a 6 e Z2 cobre x = 4 a 8, ambas de y = 0 a 10, e as duas zonas se sobrepõem entre x = 4 e 6. A ferramenta cria três feições de saída.
Parte Forma Área Campos P ∩ Z1 x 2–6, y 0–5 20 P + Z1 (zona A) P ∩ Z2 x 4–8, y 0–5 20 P + Z2 (zona B) P ∖ (Z1 ∪ Z2) x 8–10, y 0–5 10 P + null Soma das partes = 20 + 20 + 10 = 50 Área de P = 40 Diferença = 10 = área de P ∩ Z1 ∩ Z2 (x 4–6, y 0–5, contada duas vezes)
Este é o caso para lembrar. Quando polígonos Identity se sobrepõem, a área de entrada aparece uma vez por polígono, então as partes somam mais que a entrada. Se você precisa que as partes somem exatamente, dissolva ou limpe antes a camada Identity para que seus polígonos não se sobreponham.
3. A tabela de atributos da saída
Os campos de saída são os campos de entrada, depois os campos Identity, depois os campos de rastreamento. Toda feição de saída tem o mesmo conjunto de campos, o que torna a camada segura para abrir em um Shapefile ou em um banco de dados. Um campo que não se aplica é null, não está ausente.
Campos = campos de entrada + campos Identity + campos de rastreamento Regra de conflito de nomes: name → name_1 → name_2 … (vencem os nomes de entrada) Campos de rastreamento (opcionais) FID_input índice da feição de entrada (0, 1, 2 …) FID_identity índice do polígono Identity, ou -1 para «nenhum» identity_status overlap | input_only
O valor -1 em FID_identity para «sem polígono Identity» é a mesma regra do ArcGIS. Ele permite filtrar os dois tipos de parte com um único teste.
4. Ponto em polígono: a regra do raio
Para decidir se um ponto está dentro de um polígono Identity, trace um raio do ponto para a direita e conte quantas vezes ele cruza o limite do polígono. Um número ímpar significa dentro, um número par significa fora. Buracos não precisam de caso especial: suas arestas são contadas como qualquer outra, e por isso um ponto em um buraco não recebe atributos desse polígono.
Ponto P = (x, y). Aresta de (xi, yi) a (xj, yj). A aresta é cruzada quando: (yi > y) ≠ (yj > y) e x < xi + (y − yi) · (xj − xi) / (yj − yi) P está dentro ⇔ o número de arestas cruzadas é ímpar Identity dá a P os atributos do polígono ⇔ P está dentro ou sobre uma aresta
5. Interseção e diferença de polígonos com linha de varredura
As operações booleanas com polígonos têm uma longa história na computação gráfica. Sutherland e Hodgman (1974) conseguiam recortar contra uma janela convexa. Weiler e Atherton (1977) trataram formas côncavas e buracos. Vatti (1992) e Greiner e Hormann (1998) tornaram o caso geral prático. Os dados de SIG precisam desse caso geral: qualquer forma, com buracos, muitas partes e arestas que se tocam.
Esta ferramenta usa o polyclip-ts por meio do Turf.js. Ele se baseia no algoritmo de linha de varredura de Martínez, Rueda e Feito (2009). Uma linha vertical imaginária se move da esquerda para a direita sobre os dois polígonos e só para em vértices e pontos de cruzamento. A cada parada, cada aresta é marcada como dentro ou fora do outro polígono. Para uma interseção, o resultado mantém as arestas dentro do outro polígono, e para uma diferença mantém as arestas fora. Com n arestas e k cruzamentos o custo é cerca de O((n + k) · log n).
6. De onde vem o nome
O nome é mais antigo que a web. O ARC/INFO, o primeiro grande SIG vetorial comercial, tinha um conjunto de comandos de sobreposição: CLIP, ERASE, IDENTITY, INTERSECT, UNION e UPDATE. O ArcGIS manteve os nomes. A sobreposição como método vem de mais longe, do Canada Geographic Information System dos anos 1960 e das sobreposições de mapas desenhadas à mão em filme transparente que os planejadores usavam antes dos computadores, e que Ian McHarg tornou famosas com «Design with Nature» (1969).
A comparação com o filme ainda ajuda. Identity é como colocar o mapa de zonas sobre o seu mapa de lotes, desenhar as bordas das zonas nos lotes e depois escrever o nome da zona em cada parte.
7. Medir os resultados
O painel de resultados informa áreas e comprimentos na superfície da Terra, não em graus. As áreas usam a fórmula esférica de anel de Chamberlain e Duquette (NASA JPL, 2007), que o Turf.js usa. Os comprimentos usam a fórmula de haversine. Ambas usam o raio médio da Terra R = 6.371.008,8 m.
Área do anel (λ = longitude, φ = latitude, em radianos): A = (R² / 2) · | Σ (λ(i+1) − λ(i−1)) · sin φi | Comprimento do segmento (haversine): h = sin²(Δφ / 2) + cos φ1 · cos φ2 · sin²(Δλ / 2) d = 2R · asin(√h) R = 6 371 008,8 m
Uma esfera é um bom modelo da Terra. Para áreas e comprimentos, o erro costuma ficar abaixo de 1 por cento. Isso basta para planejar e para conferir um resultado. Para valores legais ou de precisão topográfica, meça de novo em um sistema de coordenadas projetado local.
Identity nesta ferramenta, no ArcGIS Pro e no QGIS, comparados
Os três dão as mesmas partes com dados normais. Eles diferem em custo, instalação e na quantidade de dados que aguentam. Aqui vai uma visão lado a lado.
| Característica | Esta ferramenta | ArcGIS Pro | QGIS |
|---|---|---|---|
| Nome da ferramenta | Identity Overlay | Identity | Sem ferramenta única: Interseção + Diferença + Mesclar |
| Preço | Grátis, sem conta | Licença ArcGIS paga | Grátis e de código aberto |
| Instalação | Nenhuma, roda no navegador | Aplicativo de mesa para Windows | Aplicativo de mesa para Windows, macOS e Linux |
| Formatos de entrada | GeoJSON, Shapefile ZIP, KML, KMZ, GPX, WKT | Geodatabases, shapefiles e muitos outros | Tudo o que o GDAL/OGR consegue ler |
| Trata pontos, linhas e polígonos | Sim, até misturados em uma camada | Sim, um tipo de geometria por camada | Sim, um tipo de geometria por camada |
| Atributos na saída | Campos de entrada e Identity, campos de rastreamento opcionais | Campos de entrada e Identity, campos FID por opção | Campos de entrada e de sobreposição da Interseção, vazios na Diferença |
| Automação | Nenhuma, uma execução por vez | arcpy e ModelBuilder | PyQGIS e o Modelador gráfico |
| Conjuntos de dados muito grandes | Até 50 MB por arquivo | Sim | Sim |
| Para onde vão seus dados | Ficam no seu navegador | Ficam no seu computador | Ficam no seu computador |
Minha recomendação: se seus dados estão em uma geodatabase do ArcGIS, use a ferramenta Identity do ArcGIS Pro. Ela foi feita para isso, e o arcpy permite repetir o trabalho. Se você quer um SIG de mesa completo sem custo, o QGIS faz com a receita de dois passos acima, e o GeoPandas faz em uma linha.
Esta ferramenta vence quando você precisa de um resultado em um minuto: alguém manda um Shapefile compactado de lotes e um KML de zonas, e você precisa dos lotes divididos por zona com as duas tabelas de atributos. Você não precisa instalar nada, e nada sai do seu computador. É também um jeito claro de aprender como o Identity se comporta, porque você vê cada corte no mapa.
10 casos de uso reais
O Identity responde à pergunta «em que zona, distrito ou classe cai cada parte da minha feição?» sem perder nada da feição. Estes são os trabalhos que vejo com mais frequência.
- Lotes divididos por zona de inundação. Um planejador sobrepõe lotes e zonas de inundação. Cada lote é cortado ao longo da borda da zona, e cada parte conhece sua zona e a profundidade da inundação. Lotes fora de todas as zonas ficam na camada com os campos de zona vazios, então a contagem de lotes nunca cai.
- Uso do solo e zoneamento. Uma cidade sobrepõe seus polígonos de uso do solo com os distritos de zoneamento para achar onde o uso real difere do zoneamento. Cada parte leva os dois campos, então um único filtro mostra as divergências.
- Estradas por município. Um órgão rodoviário corta uma camada nacional de estradas pelos limites municipais. Cada trecho de estrada recebe o nome do município, e os trechos podem ser somados para dar os quilômetros de estrada por município.
- Habitat por status de proteção. Uma ecóloga sobrepõe um mapa de habitats com áreas protegidas. O resultado mostra, para cada mancha de habitat, qual parte é protegida e sob qual designação, e qual parte não é.
- Poços e instalações por bacia hidrográfica. Um hidrólogo marca cada ponto de poço com a bacia em que ele cai. Pontos em nenhuma bacia são mantidos com campos vazios, o que também ajuda a achar pontos com coordenadas erradas.
- Solos e talhões agrícolas. Um agrônomo sobrepõe os limites dos talhões com as unidades do mapa de solos. Cada talhão se divide em uma parte por tipo de solo, e a área por tipo de solo vira uma coluna para o plano de adubação.
- Clientes por área de atendimento. Uma concessionária sobrepõe pontos de clientes com suas áreas de atendimento. Cada cliente mantém seu registro e ganha o código da área e o operador, e clientes fora de qualquer área aparecem pelos campos vazios.
- Trilhas por região. Um trilheiro ou pesquisador sobrepõe uma trilha GPX com polígonos de regiões. A trilha é cortada em cada divisa, e cada parte leva o nome da região, então o comprimento por região está a uma soma de distância.
- Dados de censo para áreas personalizadas. Um analista de mercado sobrepõe as áreas de influência de lojas com setores censitários. As partes levam os campos dos setores, e as proporções de área servem para ponderar os números.
- Ensinar análise de sobreposição. Professores mostram Intersect, Erase e Identity lado a lado com os mesmos dados de exemplo. Os alunos veem que o Identity são os dois primeiros juntos, o que torna a regra de conjuntos fácil de lembrar.
Perguntas frequentes
Respostas diretas para as perguntas que as pessoas fazem sobre a sobreposição Identity em SIG.
1. O que a ferramenta Identity faz em SIG?
O Identity mantém cada feição da camada de entrada e a divide onde ela se sobrepõe aos polígonos de uma camada Identity. As partes dentro de um polígono recebem os atributos desse polígono. As partes fora de todos os polígonos ficam na saída com valores vazios nos campos Identity. A saída cobre toda a entrada.
2. Qual é a diferença entre Identity e Union?
O Union mantém tudo das duas camadas, inclusive os polígonos Identity que não tocam nenhuma feição de entrada. O Identity mantém só a extensão da camada de entrada. Se a sua entrada é a camada que importa e a segunda só a marca, use Identity. Se as duas camadas importam igualmente, use Union.
3. Qual é a diferença entre Identity e Intersect?
O Intersect mantém só a parte em que as duas camadas se sobrepõem e descarta o resto. O Identity mantém essa parte também, e mantém ainda a entrada fora da sobreposição. Identity é Intersect mais Erase.
4. Qual é a diferença entre Identity e uma junção espacial?
Uma junção espacial deixa a geometria da entrada sem mudança e copia atributos de uma feição correspondente. O Identity corta a geometria ao longo das bordas Identity, e assim cada parte recebe os atributos certos. Use a junção espacial quando as feições precisam ficar inteiras, e o Identity quando você precisa saber qual parte está em qual zona.
5. O QGIS tem uma ferramenta Identity?
Não com esse nome. No QGIS você executa Interseção e Diferença com as mesmas duas camadas e mescla as saídas com Mesclar camadas vetoriais. O resultado equivale ao Identity. No GeoPandas o mesmo trabalho é overlay(df1, df2, how="identity").
6. Quais atributos a saída mantém?
Cada atributo da feição de entrada é copiado para cada parte. Os atributos do polígono Identity são adicionados como campos novos. As partes fora de todos os polígonos Identity têm valores null nesses campos. Como opção, a ferramenta adiciona FID_input, FID_identity, identity_status e a área, o comprimento ou o número de pontos de cada parte.
7. O que acontece quando um campo Identity tem o mesmo nome de um campo de entrada?
O campo de entrada mantém o nome e o campo Identity ganha um sufixo, por exemplo name e name_1. É a mesma regra do ArcGIS. A caixa de resultados lista cada campo renomeado, então você vê o que mudou.
8. Por que minha saída tem mais feições que minha entrada?
As feições são cortadas onde cruzam uma borda Identity, então uma feição de entrada pode virar várias partes de saída. Se seus polígonos Identity se sobrepõem entre si, a sobreposição aparece também uma vez por polígono. Ative os campos FID e agrupe por FID_input para ver quais partes vieram da mesma feição.
9. Posso usar linhas e pontos, ou só polígonos?
Como entrada você pode usar os três. As linhas são cortadas nas bordas Identity, e os pontos recebem os atributos do polígono que os contém. A camada Identity precisa ter polígonos, porque só um polígono dá uma área para sobrepor.
10. O que acontece com feições exatamente sobre uma borda Identity?
A borda conta como dentro. Um ponto exatamente na borda recebe os atributos desse polígono, e o mesmo vale para um trecho de linha que corre pela borda. Um polígono que só toca a borda por fora não é cortado. Um ponto em uma borda compartilhada por dois polígonos Identity vira dois pontos de saída, um para cada polígono.
11. Por que as áreas das minhas partes somam mais que a entrada?
Isso acontece quando polígonos Identity se sobrepõem entre si. A área de entrada na sobreposição é contada uma vez por polígono. Limpe ou dissolva antes a camada Identity se você precisa que as partes somem exatamente. O exemplo resolvido nesta página mostra os números.
12. Quais formatos de arquivo posso enviar e baixar?
Você pode enviar GeoJSON, um Shapefile da Esri compactado em ZIP (com .shp, .shx e .dbf, mais .prj para dados projetados), KML, KMZ, GPX e WKT. Você pode baixar GeoJSON, KML e CSV com uma coluna de geometria WKT. O GeoJSON é a melhor escolha para o ArcGIS Pro ou o QGIS, porque mantém os tipos dos atributos.
13. Meus dados são enviados para um servidor?
Não. Ler os arquivos, a sobreposição e gravar a saída rodam no seu navegador. Seus arquivos nunca saem do seu computador. Só os blocos opcionais do mapa base vêm da internet, e apenas depois que você ativa o mapa base.
14. Posso usar dados projetados, como UTM?
A ferramenta trabalha em longitude e latitude WGS84 (EPSG:4326). Um Shapefile em ZIP em UTM ou em uma grade nacional é convertido para WGS84 ao carregar, desde que o arquivo .prj esteja dentro do ZIP. O GeoJSON já deve estar em WGS84, como o padrão GeoJSON exige.
15. Nenhuma feição recebeu atributos Identity. O que deu errado?
A causa mais comum é que as duas camadas não se sobrepõem. Ative o mapa base e dê zoom em cada camada para conferir onde estão. Um Shapefile sem o arquivo .prj costuma cair no lugar errado. Confira também se você escolheu a camada de polígonos como camada Identity, e não como entrada.
16. Como executo o Identity com arcpy ou GeoPandas?
No ArcGIS Pro, chame arcpy.analysis.Identity("parcels", "flood_zones", "parcels_zoned"). No GeoPandas, chame geopandas.overlay(parcels, flood, how="identity"). Os dois aparecem com código completo nesta página. Um laço for sobre várias camadas é onde os scripts mais economizam tempo.
17. Os números de área e comprimento são precisos?
Eles são medidos em uma esfera com raio de 6.371.008,8 m, então estão em metros quadrados e metros reais, não em graus. O erro em relação ao elipsoide verdadeiro costuma ficar abaixo de 1 por cento. Para valores legais ou de precisão topográfica, meça de novo em um sistema de coordenadas projetado local.
Bibliotecas usadas e créditos
Esta ferramenta é construída sobre software de código aberto. Muito obrigado às pessoas que escrevem e mantêm esses projetos.
- Leaflet 1.9 · BSD-2-Clause · Volodymyr Agafonkin and contributorsDesenha o mapa interativo, as camadas, as ferramentas de desenho e os popups.
- Turf.js 7 (@turf/intersect, @turf/difference, @turf/area, @turf/boolean-point-in-polygon) · MIT · Turf authorsInterseção e diferença de polígonos para a sobreposição, área geodésica e o teste de ponto em polígono.
- polyclip-ts · MIT · Luiz Felipe Machado Barboza, based on polygon-clipping by Mike FogelO motor booleano de polígonos por trás do intersect e do difference do Turf. Usa o algoritmo de linha de varredura de Martinez-Rueda com aritmética de precisão arbitrária.
- point-in-polygon-hao · MIT · Rowan WinsemiusO teste rápido de ponto em polígono que decide quais pontos e pedaços de linha caem dentro de cada polígono Identity.
- shpjs · MIT · Calvin MetcalfLê Shapefiles da Esri compactados (.shp, .shx, .dbf, .prj, .cpg) no navegador.
- proj4js · MIT · proj4js contributorsConverte Shapefiles projetados para WGS84 usando o arquivo .prj (usado pelo shpjs).
- @tmcw/togeojson · BSD-2-Clause · Tom MacWrightConverte arquivos KML e GPX em GeoJSON.
- JSZip · MIT ou GPL-3.0 · Stuart KnightleyAbre pacotes KMZ para ler o arquivo KML dentro deles.
- @terraformer/wkt · MIT · Terraformer contributorsLê entrada WKT e grava a coluna de geometria WKT na exportação CSV.
- OpenStreetMap, Protomaps (hosted by KONAKTIVE), CARTO, Esri World Imagery · ODbL e termos do provedor · OpenStreetMap contributors, Protomaps, KONAKTIVE, CARTO, EsriBlocos e imagens do mapa base, mostrados só quando você ativa o mapa base.
A etapa de corte de linhas (dividir segmentos nos cruzamentos com a borda e testar cada pedaço) foi escrita para este site e é compartilhada com as ferramentas Clip e Erase. O motor Identity é verificado com testes automatizados: polígonos que cruzam uma ou duas zonas, linhas através de buracos, pontos dentro de duas zonas sobrepostas e sobre bordas, nomes de campo em conflito, e a regra de que as partes sobrepostas mais as partes restantes cobrem toda a entrada.
Ferramentas de geoprocessamento relacionadas
Todo o trabalho de sobreposição roda no seu navegador. Nenhum arquivo é enviado a um servidor. Blocos do mapa © colaboradores do OpenStreetMap, desenhados com Protomaps (hospedado por KONAKTIVE), com CARTO como reserva. Imagens de satélite: Esri.
