Compartir vía


Detalles de formatos de datos admitidos

En este artículo se proporcionan detalles sobre la compatibilidad de lectura y escritura para todas las etiquetas XML y los tipos de geometría de Well-Known Text. También detalla cómo se analizan los datos espaciales delimitados en el módulo de E/S espacial.

Espacios de nombres XML admitidos

El módulo de E/S espacial admite etiquetas XML de los siguientes espacios de nombres.

Prefijo de espacio de nombres URI de espacio de nombres Notas
atom http://www.w3.org/2005/Atom
geo http://www.w3.org/2003/01/geo/wgs84_pos# Compatibilidad con solo lectura en archivos GeoRSS.
georss http://www.georss.org/georss
geourl http://geourl.org/rss/module/ Compatibilidad con solo lectura en archivos GeoRSS.
gml http://www.opengis.net/gml
gpx http://www.topografix.com/GPX/1/1
gpxx http://www.garmin.com/xmlschemas/GpxExtensions/v3 Compatibilidad con solo lectura en archivos GPX. Analiza y usa DisplayColor. Todas las demás propiedades agregadas a los metadatos de la forma.
gpx_style http://www.topografix.com/GPX/gpx_style/0/2 Se admite en archivos GPX. Usa color de línea.
gx http://www.google.com/kml/ext/2.2
kml http://www.opengis.net/kml/2.2
rss Solo lectura. GeoRSS escribe con el formato Atom.

Elementos XML admitidos

El módulo de E/S espacial admite los siguientes elementos XML. Las etiquetas XML que no se admitan se convierten en un objeto JSON. A continuación, cada etiqueta se agrega como una propiedad en el campo properties de la capa o la forma primaria.

Elementos KML

El módulo de E/S espacial admite los siguientes elementos KML.

Nombre del elemento Lectura Escritura Notas
address partial El objeto se analiza, pero no se usa para la forma de posicionamiento.
AddressDetails partial no El objeto se analiza, pero no se usa para la forma de posicionamiento.
atom:author
atom:link
atom:name
BalloonStyle partial partial displayMode no se admite. Se convierte a una propiedad PopupTemplate. Para escribir, agregue una propiedad popupTemplate como una propiedad de la característica para la que desee escribirla.
begin
color Incluye #AABBGGRR y #BBGGRR. Analizado en una cadena de color CSS
colorMode no
coordinates
Data
description
displayName
Document
drawOrder partial no Se lee para las superposiciones de suelo y se usa para ordenarlas.
east
end
ExtendedData Admite Data, SimpleData o Schema sin tipo y los reemplazos de entidad del formulario $[dataName].
extrude partial partial Solo se admite para los polígonos. La multigeometría que tiene polígonos de diferentes altos se divide en características individuales. No se admiten los estilos de línea. Los polígonos con una altitud de 0 se representan como un polígono plano. Al leer, la altitud de la primera coordenada del anillo exterior se agrega como una propiedad de altura del polígono. A continuación, se usa la altitud de la primera coordenada para representar el polígono en el mapa.
fill
Folder
GroundOverlay color no se admite.
heading partial no Analizado pero no representado por SimpleDataLayer. Solo escribe si los datos se almacenan en la propiedad de la forma.
hotSpot partial Solo escribe si los datos se almacenan en la propiedad de la forma. Las unidades se configuran solo como "píxeles".
href
Icon partial partial Analizado pero no representado por SimpleDataLayer. Solo escribe la propiedad icon de la forma si contiene un URI de datos. Solo se admite href.
IconStyle partial partial Se analizan los valores icon, heading, colorMode y hotspots, pero no se representan en SimpleDataLayer
innerBoundaryIs
kml
LabelStyle no no
LatLonBox
gx:LatLonQuad
LinearRing
LineString
LineStyle colorMode no se admite.
Link no Solo se admite la propiedad href para los vínculos de red.
MultiGeometry partial partial Se puede desglosar en características individuales cuando se lee.
name
NetworkLink no Los vínculos deben estar en el mismo dominio que el documento.
NetworkLinkControl no no
north
open
outerBoundaryIs
outline
overlayXY no no
Pair partial no Solo se admite el estilo normal en un StyleMap. highlight no se admite.
phoneNumber
PhotoOverlay no no
Placemark
Point
Polygon
PolyStyle
Region partial partial LatLongBox se admite en el nivel de documento.
rotation no no
rotationXY no no
scale no no
Schema
SchemaData
schemaUrl partial No admite la carga de estilos de documentos externos que no están incluidos en una KMZ.
ScreenOverlay no no
screenXY no no
SimpleData
SimpleField
size no no
Snippet partial partial El atributo maxLines se omite.
south
Style
StyleMap partial no Solo se admite el estilo normal en un StyleMap.
styleUrl partial No se admiten direcciones URL de estilo externo.
text No se admite la sustitución de $[geDirections]
textColor
TimeSpan
TimeStamp
value
viewRefreshMode partial no Si apunta a un servicio WMS, solo se admite onStop para las superposiciones de suelo. Anexa BBOX={bboxWest},{bboxSouth},{bboxEast},{bboxNorth} a la dirección URL y se actualiza a medida que se mueve la asignación.
visibility
west
when
width

Elementos GeoRSS

El módulo de E/S espacial admite los siguientes elementos GeoRSS.

Nombre del elemento Lectura Escritura Notas
atom:author
atom:category
atom:content
atom:contributor
atom:email
atom:entry
atom:feed
atom:icon
atom:id
atom:link
atom:logo
atom:name
atom:published
atom:rights
atom:source
atom:subtitle
atom:summary
atom:title
atom:updated
atom:uri
geo:lat no Se escribe como un georss:point.
geo:lon no Se escribe como un georss:point.
geo:long no Se escribe como un georss:point.
georss:box no Se lee como un polígono y se le asigna una propiedad subType de "Rectangle".
georss:circle
georss:elev
georss:featurename
georss:featuretypetag
georss:floor
georss:line
georss:point
georss:polygon
georss:radius
georss:relationshiptag
georss:where
geourl:latitude no Se escribe como un georss:point.
geourl:longitude no Se escribe como un georss:point.
position no Algunas fuentes XML ajustan GML con una etiqueta de posición en lugar de encapsularla con una etiqueta georss:where. Lea esta etiqueta, pero escriba mediante una etiqueta georss:where.
rss no GeoRSS escrito en formato ATOM.
rss:author partial Se escribe como un atom:author.
rss:category partial Se escribe como un atom:category.
rss:channel no
rss:cloud no
rss:comments no
rss:copyright partial Se escribe como un atom:rights si la forma no tiene ya una propiedad properties rights.
rss:description partial Se escribe como un atom:content si la forma no tiene ya una propiedad properties content.
rss:docs no
rss:enclosure no
rss:generator no
rss:guid partial Se escribe como un atom:id si la forma no tiene ya una propiedad properties id.
rss:image partial Se escribe como un atom:logo si la forma no tiene ya una propiedad properties logo.
rss:item partial Se escribe como un atom:entry.
rss:language no
rss:lastBuildDate partial Se escribe como un atom:updated si la forma no tiene ya una propiedad properties updated.
rss:link partial Se escribe como un atom:link.
rss:managingEditor partial Se escribe como un atom:contributor.
rss:pubDate partial Se escribe como un atom:published si la forma no tiene ya una propiedad properties published.
rss:rating no
rss:skipDays no
rss:skipHours no
rss:source partial Se escribe como un atom:source que contiene un atom:link.
rss:textInput no
rss:title partial Se escribe como un atom:title.
rss:ttl no
rss:webMaster no

Elementos de GML

El módulo de E/S espacial admite los siguientes elementos de GML.

Nombre del elemento Lectura Escritura Notas
gml:coordinates no Se escribe como gml:posList.
gml:curveMember no
gml:curveMembers no
gml:Box no Se escribe como gml:Envelope.
gml:description
gml:Envelope
gml:exterior
gml:Feature no Se escribe como una forma.
gml:FeatureCollection no Se escribe como una colección Geometry.
gml:featureMember no Se escribe como una colección Geometry.
gml:geometry no Se escribe como una forma.
gml:geometryMember
gml:geometryMembers
gml:identifier
gml:innerBoundaryIs no Se escribe con gml.interior.
gml:interior
gml:LinearRing
gml:LineString
gml:lineStringMember
gml:lineStringMembers no
gml:MultiCurve no Solo lee miembros gml:LineString. Se escribe como gml.MultiLineString
gml:MultiGeometry partial partial Solo se lee como FeatureCollection.
gml:MultiLineString
gml:MultiPoint
gml:MultiPolygon
gml:MultiSurface no Solo lee miembros gml:Polygon. Se escribe como gml.MultiPolygon
gml:name
gml:outerBoundaryIs no Se escribe con gml.exterior.
gml:Point
gml:pointMember
gml:pointMembers no
gml:Polygon
gml:polygonMember
gml:polygonMembers no
gml:pos
gml:posList
gml:surfaceMember

Más notas

  • Se busca en los elementos de miembro una geometría que pueda estar oculta en los elementos secundarios. Esta operación de búsqueda es necesaria, ya que muchos formatos XML que se extienden desde GML pueden no colocar una geometría como elemento secundario directo de un elemento de miembro.
  • srsName es parcialmente compatible con las coordenadas WGS84 y los códigos siguientes: EPSG: 4326 y web Mercator EPSG: 3857, o uno de sus códigos alternativos. Cualquier otro sistema de coordenadas se analiza como WGS84 tal cual.
  • A menos que se especifique al leer una fuente XML, el orden del eje se determina en función de las sugerencias de la fuente XML. Se proporciona una preferencia para el orden de los ejes "latitud, longitud".
  • A menos que se especifique un espacio de nombres GML personalizado para las propiedades al escribir en un archivo GML, no se agrega información de propiedad adicional.

Elementos GPX

El módulo de E/S espacial admite los siguientes elementos GPX.

Nombre del elemento Lectura Escritura Notas
gpx:ageofdgpsdata
gpx:author
gpx:bounds Se convierte en un LocationRect cuando se lee.
gpx:cmt
gpx:copyright
gpx:desc Se copia en una propiedad description cuando la lectura se alinea con otros formatos XML.
gpx:dgpsid
gpx:ele
gpx:extensions partial partial Cuando se lee, se extrae la información de estilo. Todas las demás extensiones se acoplan en un objeto JSON simple. Solo se escribe la información de estilo de la forma.
gpx:geoidheight
gpx:gpx
gpx:hdop
gpx:link
gpx:magvar
gpx:metadata
gpx:name
gpx:pdop
gpx:rte
gpx:rtept
gpx:sat
gpx:src
gpx:sym Se captura el valor, pero no se usa para modificar el icono de alfiler.
gpx:text
gpx:time
gpx:trk
gpx:trkpt
gpx:trkseg
gpx:type
gpx:vdop
gpx:wpt
gpx_style:color
gpx_style:line partial partial Se admiten color, opacity, width y lineCap.
gpx_style:opacity
gpx_style:width
gpxx:DisplayColor no Se utiliza para especificar el color de una forma. Si escribe, se usa el color gpx_style:line en su lugar.
gpxx:RouteExtension partial no Todas las propiedades se leen en properties. Sólo se utiliza DisplayColor.
gpxx:TrackExtension partial no Todas las propiedades se leen en properties. Sólo se utiliza DisplayColor.
gpxx:WaypointExtension partial no Todas las propiedades se leen en properties. Sólo se utiliza DisplayColor.
gpx:keywords
gpx:fix

Más notas

Al escribir;

  • Los multipuntos se dividen en puntos de trayecto individuales.
  • Los polígonos y multipolígonos se escriben como pistas.

Tipos de geometría de texto Well-Known Text

Tipo Geometry Lectura Escritura
POINT x x
POINT Z x x
POINT M x x[2]
POINT ZM x[1][2]
LINESTRING x x
LINESTRING Z x x
LINESTRING M x x[2]
LINESTRING ZM x[1][2]
POLYGON x x
POLYGON Z x x
POLYGON M x x[2]
POLYGON 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] Solo se captura el parámetro Z y se agrega como tercer valor en el valor de Position.

[2] El parámetro M no se captura.

Compatibilidad con datos espaciales delimitados

Los datos espaciales delimitados, como los archivos de valores separados por comas (CSV), suelen tener columnas que contienen datos espaciales. Por ejemplo, puede haber columnas que contengan información de latitud y longitud. En el formato Well-Known Text (WKT) puede haber una columna que contenga datos de geometría espacial.

Detección de columnas de datos espaciales

Al leer un archivo delimitado que contiene datos espaciales, se analiza el encabezado para determinar qué columnas contienen campos de ubicación. Si el encabezado contiene información de tipos, se usa para convertir los valores de celda al tipo adecuado. Si no se especifica ningún encabezado, se analiza la primera fila para generar un encabezado. Al analizar la primera fila, se ejecuta una comprobación para buscar coincidencias de los nombres de columna con los nombres siguientes, sin distinción entre mayúsculas y minúsculas. El orden de los nombres es la prioridad, en caso de que existan dos o más nombres en un archivo.

Latitud

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

Longitud

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

Elevation

  • elevation
  • elv
  • altitude
  • alt
  • z

Geography

La primera fila de datos se examina en busca de cadenas con un formato Well-Known Text.

Tipos de columnas de datos delimitados

Al examinar la fila de encabezado, toda la información de tipo que se encuentre en el nombre de columna se extrae y se utiliza para convertir las celdas de esa columna. A continuación se muestra un ejemplo de un nombre de columna que tiene un valor de tipo: "ColumnName (typeName)". Se admiten los siguientes nombres de tipo que no distinguen mayúsculas de minúsculas:

Números

  • edm.int64
  • int
  • long
  • edm.double
  • FLOAT
  • double
  • number

Valores booleanos

  • edm.boolean
  • bool
  • boolean

Fechas

  • edm.datetime
  • date
  • datetime

Geography

  • edm.geography
  • geography

Cadenas

  • edm.string
  • varchar
  • text
  • string

Si no se puede extraer información de tipo del encabezado y la opción de escritura dinámica está habilitada al leer, cada celda se analiza individualmente para determinar qué tipo de datos es el más adecuado para convertirse.

Pasos siguientes

Para obtener más ejemplos de código para agregar a los mapas:

Lectura y escritura de datos espaciales