Partilhar via

Detalhes do formato de dados suportado

  • Artigo

Este artigo fornece detalhes sobre o suporte de leitura e gravação para todas as marcas XML e tipos de geometria de texto conhecido. Ele também detalha como os dados espaciais delimitados são analisados no módulo de E/S espacial.

Namespaces XML suportados

O módulo de E/S espacial suporta marcas XML dos namespaces a seguir.

Prefixo do namespace Namespace URI Notas
atom http://www.w3.org/2005/Atom
geo http://www.w3.org/2003/01/geo/wgs84_pos# Suporte somente leitura em arquivos GeoRSS.
georss http://www.georss.org/georss
geourl http://geourl.org/rss/module/ Suporte somente leitura em arquivos GeoRSS.
gml http://www.opengis.net/gml
gpx http://www.topografix.com/GPX/1/1
gpxx http://www.garmin.com/xmlschemas/GpxExtensions/v3 Suporte somente leitura em arquivos GPX. Analisa e usa DisplayColor. Todas as outras propriedades adicionadas aos metadados da forma.
gpx_style http://www.topografix.com/GPX/gpx_style/0/2 Suportado em arquivos GPX. Usa a cor da linha.
gx http://www.google.com/kml/ext/2.2
kml http://www.opengis.net/kml/2.2
rss Somente leitura. GeoRSS escreve usando o formato Atom.

Elementos XML suportados

O módulo de E/S espacial suporta os seguintes elementos XML. Todas as marcas XML que não são suportadas são convertidas em um objeto JSON. Em seguida, cada tag é adicionada como uma propriedade no properties campo da forma ou camada pai.

Elementos KML

O módulo de E/S espacial suporta os seguintes elementos KML.

Nome do Elemento Lida Escrita Notas
address parcial sim O objeto é analisado, mas não é usado para posicionar a forma.
AddressDetails parcial não O objeto é analisado, mas não é usado para posicionar a forma.
atom:author sim sim
atom:link sim sim
atom:name sim sim
BalloonStyle parcial parcial displayMode não é suportado. Convertido em um PopupTemplatearquivo . Para escrever, adicione uma popupTemplate propriedade como uma propriedade do recurso para o qual você deseja escrevê-la.
begin sim sim
color sim sim Inclui #AABBGGRR e #BBGGRR. Analisado em uma cadeia de caracteres de cores CSS
colorMode sim não
coordinates sim sim
Data sim sim
description sim sim
displayName sim sim
Document sim sim
drawOrder parcial não Leia para sobreposições de solo e usado para classificá-los.
east sim sim
end sim sim
ExtendedData sim sim Suporta substituições não tipadas Dataou SchemaSimpleData , e entidades do formulário $[dataName].
extrude parcial parcial Suportado apenas para polígonos. Multigeometria que têm polígonos de diferentes alturas são divididos em características individuais. Não há suporte para estilos de linha. Polígonos com uma altitude de 0 é renderizado como um polígono plano. Ao ler, a altitude da primeira coordenada no anel exterior é adicionada como uma propriedade de altura do polígono. Em seguida, a altitude da primeira coordenada é usada para renderizar o polígono no mapa.
fill sim sim
Folder sim sim
GroundOverlay sim sim color não é suportado
heading parcial não Analisado, mas não processado por SimpleDataLayer. Só grava se os dados forem armazenados na propriedade da forma.
hotSpot sim parcial Só grava se os dados forem armazenados na propriedade da forma. As unidades são saídas apenas como "pixels".
href sim sim
Icon parcial parcial Analisado, mas não processado por SimpleDataLayer. Só grava a propriedade icon da forma se ela contiver dados URI. Só o href é suportado.
IconStyle parcial parcial icon, heading, colorMode, e hotspots os valores são analisados, mas não renderizados por SimpleDataLayer
innerBoundaryIs sim sim
kml sim sim
LabelStyle não não
LatLonBox sim sim
gx:LatLonQuad sim sim
LinearRing sim sim
LineString sim sim
LineStyle sim sim colorMode não é suportado.
Link sim não Somente a propriedade é suportada href para links de rede.
MultiGeometry parcial parcial Pode ser dividido em recursos individuais quando lido.
name sim sim
NetworkLink sim não Os links precisam estar no mesmo domínio do documento.
NetworkLinkControl não não
north sim sim
open sim sim
outerBoundaryIs sim sim
outline sim sim
overlayXY não não
Pair parcial não Apenas o normal estilo em um StyleMap é suportado. highlight não é suportado.
phoneNumber sim sim
PhotoOverlay não não
Placemark sim sim
Point sim sim
Polygon sim sim
PolyStyle sim sim
Region parcial parcial LatLongBox é suportado ao nível do documento.
rotation não não
rotationXY não não
scale não não
Schema sim sim
SchemaData sim sim
schemaUrl parcial sim Não suporta o carregamento de estilos de documentos externos que não estão incluídos em um KMZ.
ScreenOverlay não não
screenXY não não
SimpleData sim sim
SimpleField sim sim
size não não
Snippet parcial parcial maxLines atributo é ignorado.
south sim sim
Style sim sim
StyleMap parcial não Apenas o estilo normal em um StyleMap é suportado.
styleUrl parcial sim Não há suporte para URLs de estilo externo.
text sim sim A substituição de não é suportada $[geDirections]
textColor sim sim
TimeSpan sim sim
TimeStamp sim sim
value sim sim
viewRefreshMode parcial não Se apontar para um serviço WMS, só onStop há suporte para sobreposições de solo. Acrescenta ao URL e atualiza BBOX={bboxWest},{bboxSouth},{bboxEast},{bboxNorth} à medida que o mapa se move.
visibility sim sim
west sim sim
when sim sim
width sim sim

Elementos GeoRSS

O módulo IO espacial suporta os seguintes elementos GeoRSS.

Nome do Elemento Lida Escrita Notas
atom:author sim sim
atom:category sim sim
atom:content sim sim
atom:contributor sim sim
atom:email sim sim
atom:entry sim sim
atom:feed sim sim
atom:icon sim sim
atom:id sim sim
atom:link sim sim
atom:logo sim sim
atom:name sim sim
atom:published sim sim
atom:rights sim sim
atom:source sim sim
atom:subtitle sim sim
atom:summary sim sim
atom:title sim sim
atom:updated sim sim
atom:uri sim sim
geo:lat sim não Escrito como um georss:pointarquivo .
geo:lon sim não Escrito como um georss:pointarquivo .
geo:long sim não Escrito como um georss:pointarquivo .
georss:box sim não Ler como um polígono e receber uma subType propriedade de "Retângulo"
georss:circle sim sim
georss:elev sim sim
georss:featurename sim sim
georss:featuretypetag sim sim
georss:floor sim sim
georss:line sim sim
georss:point sim sim
georss:polygon sim sim
georss:radius sim sim
georss:relationshiptag sim sim
georss:where sim sim
geourl:latitude sim não Escrito como um georss:pointarquivo .
geourl:longitude sim não Escrito como um georss:pointarquivo .
position sim não Alguns feeds XML encapsulam GML com uma tag position em vez de envolvê-la com uma georss:where tag . Leia esta tag, mas escreva usando uma georss:where tag .
rss sim não GeoRSS escrito em formato ATOM.
rss:author sim parcial Escrito como um atom:authorarquivo .
rss:category sim parcial Escrito como um atom:categoryarquivo .
rss:channel sim não
rss:cloud sim não
rss:comments sim não
rss:copyright sim parcial Escrito como uma atom:rights forma if ainda não tem uma rights properties propriedade.
rss:description sim parcial Escrito como uma atom:content forma if ainda não tem uma content properties propriedade.
rss:docs sim não
rss:enclosure sim não
rss:generator sim não
rss:guid sim parcial Escrito como uma atom:id forma if ainda não tem uma id properties propriedade.
rss:image sim parcial Escrito como uma atom:logo forma if ainda não tem uma logo properties propriedade.
rss:item sim parcial Escrito como um atom:entryarquivo .
rss:language sim não
rss:lastBuildDate sim parcial Escrito como uma atom:updated forma if ainda não tem uma updated properties propriedade.
rss:link sim parcial Escrito como um atom:linkarquivo .
rss:managingEditor sim parcial Escrito como um atom:contributorarquivo .
rss:pubDate sim parcial Escrito como uma atom:published forma if ainda não tem uma published properties propriedade.
rss:rating sim não
rss:skipDays sim não
rss:skipHours sim não
rss:source sim parcial Escrito como um atom:source contendo um atom:linkarquivo .
rss:textInput sim não
rss:title sim parcial Escrito como um atom:titlearquivo .
rss:ttl sim não
rss:webMaster sim não

Elementos GML

O módulo IO espacial suporta os seguintes elementos GML.

Nome do Elemento Lida Escrita Notas
gml:coordinates sim não Escrito como gml:posList.
gml:curveMember sim não
gml:curveMembers sim não
gml:Box sim não Escrito como gml:Envelope.
gml:description sim sim
gml:Envelope sim sim
gml:exterior sim sim
gml:Feature sim não Escrito como uma forma.
gml:FeatureCollection sim não Escrito como uma coleção de geometria.
gml:featureMember sim não Escrito como uma coleção de geometria.
gml:geometry sim não Escrito como uma forma.
gml:geometryMember sim sim
gml:geometryMembers sim sim
gml:identifier sim sim
gml:innerBoundaryIs sim não Escrito usando gml.interior.
gml:interior sim sim
gml:LinearRing sim sim
gml:LineString sim sim
gml:lineStringMember sim sim
gml:lineStringMembers sim não
gml:MultiCurve sim não Só lê gml:LineString membros. Escrito como gml.MultiLineString
gml:MultiGeometry parcial parcial Ler apenas como FeatureCollection.
gml:MultiLineString sim sim
gml:MultiPoint sim sim
gml:MultiPolygon sim sim
gml:MultiSurface sim não Só lê gml:Polygon membros. Escrito como gml.MultiPolygon
gml:name sim sim
gml:outerBoundaryIs sim não Escrito usando gml.exterior.
gml:Point sim sim
gml:pointMember sim sim
gml:pointMembers sim não
gml:Polygon sim sim
gml:polygonMember sim sim
gml:polygonMembers sim não
gml:pos sim sim
gml:posList sim sim
gml:surfaceMember sim sim

Mais notas

  • Os elementos membros são procurados por uma geometria que pode ser enterrada dentro de elementos filho. Esta operação de pesquisa é necessária, pois muitos formatos XML que se estendem do GML podem não colocar uma geometria como um filho direto de um elemento membro.
  • srsName é parcialmente suportado para coordenadas WGS84 e os seguintes códigos:EPSG:4326) e web Mercator (EPSG:3857 ou um de seus códigos alternativos. Qualquer outro sistema de coordenadas é analisado como WGS84 no estado em que se encontra.
  • A menos que especificado ao ler um feed XML, a ordem dos eixos é determinada com base em dicas no feed XML. É dada preferência à ordem do eixo "latitude, longitude".
  • A menos que um namespace GML personalizado seja especificado para as propriedades ao gravar em um arquivo GML, outras informações de propriedade não serão adicionadas.

Elementos GPX

O módulo IO espacial suporta os seguintes elementos GPX.

Nome do Elemento Lida Escrita Notas
gpx:ageofdgpsdata sim sim
gpx:author sim sim
gpx:bounds sim sim Convertido em um LocationRect quando lido.
gpx:cmt sim sim
gpx:copyright sim sim
gpx:desc sim sim Copiado em uma propriedade description quando lido para alinhar com outros formatos XML.
gpx:dgpsid sim sim
gpx:ele sim sim
gpx:extensions parcial parcial Quando lidas, as informações de estilo são extraídas. Todas as outras extensões são niveladas em um objeto JSON simples. Apenas as informações de estilo de forma são escritas.
gpx:geoidheight sim sim
gpx:gpx sim sim
gpx:hdop sim sim
gpx:link sim sim
gpx:magvar sim sim
gpx:metadata sim sim
gpx:name sim sim
gpx:pdop sim sim
gpx:rte sim sim
gpx:rtept sim sim
gpx:sat sim sim
gpx:src sim sim
gpx:sym sim sim O valor é capturado, mas não é usado para alterar o ícone de pino.
gpx:text sim sim
gpx:time sim sim
gpx:trk sim sim
gpx:trkpt sim sim
gpx:trkseg sim sim
gpx:type sim sim
gpx:vdop sim sim
gpx:wpt sim sim
gpx_style:color sim sim
gpx_style:line parcial parcial color, opacity, width, são lineCap suportados.
gpx_style:opacity sim sim
gpx_style:width sim sim
gpxx:DisplayColor sim não Usado para especificar a cor de uma forma. Se escrever, gpx_style:line a cor é usada em vez disso.
gpxx:RouteExtension parcial não Todas as propriedades são lidas em properties. Apenas DisplayColor é usado.
gpxx:TrackExtension parcial não Todas as propriedades são lidas em properties. Apenas DisplayColor é usado.
gpxx:WaypointExtension parcial não Todas as propriedades são lidas em properties. Apenas DisplayColor é usado.
gpx:keywords sim sim
gpx:fix sim sim

Mais notas

Ao escrever;

  • O MultiPoints é dividido em waypoints individuais.
  • Polígonos e Multipolígonos são escritos como faixas.

Tipos de geometria de texto bem conhecidos suportados

Tipo de geometria Lida Escrita
PONTO x x
PONTO Z x x
PONTO M x x[2]
PONTO ZM x[1][2]
CADEIA DE CARACTERES DE LINHA x x
LINESTRING Z x x
LINESTRING M x x[2]
LINESTRING ZM x[1][2]
POLÍGONO x x
POLÍGONO Z x x
POLÍGONO M x x[2]
POLÍGONO ZM x[1][2]
MULTIPONTO x x
MULTIPONTO Z x x
MULTIPONTO M x x[2]
POMULTIPOINTINT ZM x[1][2]
MULTILINESTRING x x
MULTILINESTRING Z x x
MULTILINESTRING M x x[2]
MULTILINESTRING ZM x[1][2]
MULTIPOLÍGONO x x
MULTIPOLÍGONO Z x x
MULTIPOLÍGONO M x x[2]
MULTIPOLÍGONO ZM x[1][2]
GEOMETRYCOLLECTION x x
GEOMETRYCOLLECTION Z x x
GEOMETRYCOLLECTION M x x[2]
GEOMETRYCOLLECTION ZM x[1][2] x

[1] Apenas o parâmetro Z é capturado e adicionado como um terceiro valor no valor da posição.

[2] O parâmetro M não é capturado.

Suporte a dados espaciais delimitados

Dados espaciais delimitados, como arquivos de valores separados por vírgulas (CSV), geralmente têm colunas que contêm dados espaciais. Por exemplo, pode haver colunas que contenham informações de latitude e longitude. No formato Texto Conhecido, pode haver uma coluna que contenha dados de geometria espacial.

Deteção de coluna de dados espaciais

Ao ler um arquivo delimitado que contém dados espaciais, o cabeçalho é analisado para determinar quais colunas contêm campos de localização. Se o cabeçalho contiver informações de tipo, ele será usado para converter os valores de célula para o tipo apropriado. Se nenhum cabeçalho for especificado, a primeira linha será analisada para gerar um cabeçalho. Ao analisar a primeira linha, uma verificação é executada para fazer a correspondência entre os nomes das colunas e os nomes a seguir de forma que não diferencia maiúsculas de minúsculas. A ordem dos nomes é a prioridade, no caso de existirem dois ou mais nomes num ficheiro.

Latitude

  • latitude
  • lat
  • latdd
  • lat_dd
  • latitude83
  • latdecdeg
  • y
  • ycenter
  • point-y

Longitude

  • longitude
  • lon
  • lng
  • long
  • longdd
  • long_dd
  • longitude83
  • longdecdeg
  • x
  • xcenter
  • point-x

Elevation

  • elevation
  • elv
  • altitude
  • alt
  • z

Geografia

A primeira linha de dados é verificada em busca de cadeias de caracteres que estejam no formato Texto Conhecido.

Tipos de colunas de dados delimitados

Ao verificar a linha de cabeçalho, todas as informações de tipo que estão no nome da coluna são extraídas e usadas para converter as células nessa coluna. Aqui está um exemplo de um nome de coluna que tem um valor de tipo: "ColumnName (typeName)". Os seguintes nomes de tipo que não diferenciam maiúsculas de minúsculas são suportados:

Números

  • edm.int64
  • número inteiro
  • long
  • edm.duplo
  • flutuante
  • duplo
  • Número

Booleanos

  • edm.booleano
  • booleano
  • boolean

Dates

  • edm.datetime
  • data
  • datetime

Geografia

  • edm.geografia
  • geografia

Cadeias

  • edm.string
  • varchar
  • texto
  • string

Se nenhuma informação de tipo puder ser extraída do cabeçalho e a opção de digitação dinâmica estiver ativada durante a leitura, cada célula será analisada individualmente para determinar qual tipo de dados é mais adequado para ser convertido.

Próximos passos

Consulte os seguintes artigos para obter mais exemplos de código para adicionar aos seus mapas:

Ler e gravar dados espaciais