Compartilhar via

Detalhes do formato de dados com suporte

  • Artigo

Este artigo fornece informações específicas sobre o suporte de leitura e gravação para todas as marcas XML e tipos de geometria de texto Well-Known. Ele também detalha como os dados espaciais delimitados são analisados no módulo de E/S espacial.

Namespaces XML com suporte

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

Prefixo de namespace URI de namespace Observações
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 para formar metadados.
gpx_style http://www.topografix.com/GPX/gpx_style/0/2 Com suporte em arquivos GPX. Usa cor de linha.
gx http://www.google.com/kml/ext/2.2
kml http://www.opengis.net/kml/2.2
rss Somente leitura. O GeoRSS grava usando o formato Atom.

Elementos XML com suporte

O módulo de E/S espacial dá suporte aos seguintes elementos XML. Todas as marcas XML que não têm suporte são convertidas em um objeto JSON. Em seguida, cada marca é adicionada como uma propriedade no campo properties da forma ou camada principal.

Elementos KML

O módulo de E/S espacial dá suporte aos seguintes elementos KML.

Nome do elemento Ler Gravar Observações
address partial sim O objeto é analisado, mas não é usado para posicionar a forma.
AddressDetails partial 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 partial partial Não há suporte para displayMode. Convertido em um PopupTemplate. Para gravar, adicione uma propriedade popupTemplate como uma propriedade do recurso para a qual você deseja gravá-lo.
begin sim sim
color sim sim Inclui #AABBGGRR e #BBGGRR. Analisado em uma cadeia de caracteres de cor CSS
colorMode sim não
coordinates sim sim
Data sim sim
description sim sim
displayName sim sim
Document sim sim
drawOrder partial não Leia as sobreposições de solo e usadas para classificá-las.
east sim sim
end sim sim
ExtendedData sim sim Dá suporte para Data, SimpleData ou Schema não tipadas, e substituições de entidade da forma $[dataName].
extrude partial partial Com suporte apenas para polígonos. Os MultiGeometry com polígonos de diferentes alturas são divididos em recursos individuais. Não há suporte para estilos de linha. Polígonos com uma altitude de 0 são renderizados como um polígono simples. Durante a leitura, 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 Não há suporte para color
heading partial não Analisado, mas não renderizado pelo SimpleDataLayer. Só grava se os dados são armazenados na propriedade da forma.
hotSpot sim partial Só grava se os dados são armazenados na propriedade da forma. As unidades são emitidas apenas como “pixels”.
href sim sim
Icon partial partial Analisado, mas não renderizado pelo SimpleDataLayer. Somente gravará a propriedade do ícone da forma se ela contiver dados URI. Apenas href tem suporte.
IconStyle partial partial Os valores icon, heading, colorMode e hotspots são analisados, mas não sã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 Não há suporte para colorMode.
Link sim não Somente a propriedade href tem suporte para links de rede.
MultiGeometry partial partial Podem ser divididos em recursos individuais quando lidos.
name sim sim
NetworkLink sim não Os links precisam estar no mesmo domínio que o documento.
NetworkLinkControl não não
north sim sim
open sim sim
outerBoundaryIs sim sim
outline sim sim
overlayXY não não
Pair partial não Somente o estilo normal em um StyleMap tem suporte. Não há suporte para highlight.
phoneNumber sim sim
PhotoOverlay não não
Placemark sim sim
Point sim sim
Polygon sim sim
PolyStyle sim sim
Region partial partial LatLongBox tem suporte no 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 partial sim Não dá suporte ao 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 partial partial O atributo maxLines é ignorado.
south sim sim
Style sim sim
StyleMap partial não Somente o estilo normal em um StyleMap tem suporte.
styleUrl partial sim Não há suporte para URLs de estilo externo.
text sim sim Não há suporte para a substituição de $[geDirections]
textColor sim sim
TimeSpan sim sim
TimeStamp sim sim
value sim sim
viewRefreshMode partial não Se estiver apontando para um serviço do WMS, somente onStop terá suporte para as sobreposições de solo. Acrescenta BBOX={bboxWest},{bboxSouth},{bboxEast},{bboxNorth} à URL e atualizará à medida que o mapa for movido.
visibility sim sim
west sim sim
when sim sim
width sim sim

Elementos GeoRSS

O módulo de E/S espacial dá suporte aos seguintes elementos GeoRSS.

Nome do elemento Ler Gravar Observações
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 Gravado com um georss:point.
geo:lon sim não Gravado com um georss:point.
geo:long sim não Gravado com um georss:point.
georss:box sim não Lido como um polígono e fornecida uma propriedade subType 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 Gravado com um georss:point.
geourl:longitude sim não Gravado com um georss:point.
position sim não Alguns feeds XML encapsulam o GML com uma marca de posição em vez de encapsulá-lo com uma marca georss:where. Lê essa marca, mas grava usando uma marca georss:where.
rss sim não O GeoRSS gravado no formato ATOM.
rss:author sim partial Gravado como um atom:author.
rss:category sim partial Gravado como um atom:category.
rss:channel sim não
rss:cloud sim não
rss:comments sim não
rss:copyright sim partial Gravado como um atom:rights se a forma ainda não tiver uma propriedade rights properties.
rss:description sim partial Gravado como um atom:content se a forma ainda não tiver uma propriedade content properties.
rss:docs sim não
rss:enclosure sim não
rss:generator sim não
rss:guid sim partial Gravado como um atom:id se a forma ainda não tiver uma propriedade id properties.
rss:image sim partial Gravado como um atom:logo se a forma ainda não tiver uma propriedade logo properties.
rss:item sim partial Gravado como um atom:entry.
rss:language sim não
rss:lastBuildDate sim partial Gravado como um atom:updated se a forma ainda não tiver uma propriedade updated properties.
rss:link sim partial Gravado como um atom:link.
rss:managingEditor sim partial Gravado como um atom:contributor.
rss:pubDate sim partial Gravado como um atom:published se a forma ainda não tiver uma propriedade published properties.
rss:rating sim não
rss:skipDays sim não
rss:skipHours sim não
rss:source sim partial Gravado com um atom:source que contém um atom:link.
rss:textInput sim não
rss:title sim partial Gravado como um atom:title.
rss:ttl sim não
rss:webMaster sim não

Elementos GML

O módulo de E/S espacial dá suporte aos seguintes elementos GML.

Nome do elemento Ler Gravar Observações
gml:coordinates sim não Gravado como gml:posList.
gml:curveMember sim não
gml:curveMembers sim não
gml:Box sim não Gravado como gml:Envelope.
gml:description sim sim
gml:Envelope sim sim
gml:exterior sim sim
gml:Feature sim não Gravado como uma forma.
gml:FeatureCollection sim não Gravado como uma coleção de geometria.
gml:featureMember sim não Gravado como uma coleção de geometria.
gml:geometry sim não Gravado como uma forma.
gml:geometryMember sim sim
gml:geometryMembers sim sim
gml:identifier sim sim
gml:innerBoundaryIs sim não Gravado 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 Somente lê membros gml:LineString. Gravado como gml.MultiLineString.
gml:MultiGeometry partial partial Somente leitura como uma Featurecollection.
gml:MultiLineString sim sim
gml:MultiPoint sim sim
gml:MultiPolygon sim sim
gml:MultiSurface sim não Somente lê membros gml:Polygon. Gravado como gml.MultiPolygon.
gml:name sim sim
gml:outerBoundaryIs sim não Gravado 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 anotações

  • Os elementos de membro são pesquisados para uma geometria que pode ser incluída nos elementos secundários. Essa operação de pesquisa é necessária, pois muitos formatos XML que se estendem de GML podem não posicionar uma geometria como um filho direto de um elemento de membro.
  • srsName é parcialmente suportado para as 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 como está.
  • A menos que especificado durante a leitura de um feed XML, a ordem do eixo é determinada com base nas dicas no feed XML. É fornecida uma preferência para a ordem do eixo "latitude, longitude".
  • A menos que um namespace GML personalizado seja especificado para as propriedades durante a gravação em um arquivo GML, as outras informações de propriedade não são adicionadas.

Elementos GPX

O módulo de E/S espacial dá suporte aos seguintes elementos GPX.

Nome do elemento Ler Gravar Observações
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 para uma propriedade de descrição quando lido para alinhar com outros formatos XML.
gpx:dgpsid sim sim
gpx:ele sim sim
gpx:extensions partial partial Quando lidas, as informações de estilo são extraídas. Todas as outras extensões são mescladas em um objeto JSON simples. Somente as informações de estilo da forma serão gravadas.
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 pushpin.
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 partial partial color, opacity, width, lineCap têm suporte.
gpx_style:opacity sim sim
gpx_style:width sim sim
gpxx:DisplayColor sim não Usado para especificar a cor de uma forma. Se estiver escrevendo, a cor gpx_style:line será usada.
gpxx:RouteExtension partial não Todas as propriedades são lidas em properties. Somente DisplayColor é usado.
gpxx:TrackExtension partial não Todas as propriedades são lidas em properties. Somente DisplayColor é usado.
gpxx:WaypointExtension partial não Todas as propriedades são lidas em properties. Somente DisplayColor é usado.
gpx:keywords sim sim
gpx:fix sim sim

Mais anotações

Ao gravar,

  • Os MultiPoints serão divididos em pontos medianos individuais.
  • Os polígonos e subpolígonos são gravados como faixas.

Tipos de geometria de texto Well-Known com suporte

Tipo de geometria Ler Gravar
PONTO x x
PONTO Z x x
PONTO M x x[2]
PONTO ZM x[1][2]
LINESTRING 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]
MULTIPOINT x x
MULTIPOINT Z x x
MULTIPOINT 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]
MULTIPOLYGON x x
MULTIPOLYGON Z x x
MULTIPOLYGON M x x[2]
MULTIPOLYGON ZM x[1][2]
GEOMETRYCOLLECTION x x
GEOMETRYCOLLECTION Z x x
GEOMETRYCOLLECTION M x x[2]
GEOMETRYCOLLECTION ZM x[1][2] x

[1] Somente 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

Os dados espaciais delimitados, como o CSV (arquivos de valores separados por vírgula), geralmente têm colunas que contêm dados espaciais. Por exemplo, pode haver colunas que contêm informações de latitude e longitude. No formato de texto Well-Known, pode haver uma coluna que contém dados de geometria espacial.

Detecçã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 é 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 corresponder nomes de coluna com os nomes seguintes de forma a não diferenciar maiúsculas de minúsculas. A ordem dos nomes é a prioridade, caso dois ou mais nomes existam em um arquivo.

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

Elevação

  • elevation
  • elv
  • altitude
  • alt
  • z

painel Geografia do app's selecionado

A primeira linha de dados é verificada em busca de cadeias de caracteres que estejam no formato de texto Well-Known.

Tipos de coluna de dados delimitados

Ao verificar a linha de cabeçalho, qualquer informação de tipo que esteja no nome da coluna é extraída e usada 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 tipos que não diferenciam maiúsculas de minúsculas têm suporte:

Números

  • edm.int64
  • INT
  • long
  • edm.double
  • FLOAT
  • double
  • número

Boolianos

  • edm.boolean
  • bool
  • booleano

Datas

  • edm.datetime
  • date
  • DATETIME

painel Geografia do app's selecionado

  • edm.geography
  • geografia

Cadeias de caracteres

  • edm.string
  • varchar
  • text
  • string

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

Próximas etapas

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

Ler e gravar dados espaciais