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	sí	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	sí	sí
atom:link	sí	sí
atom:name	sí	sí
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	sí	sí
color	sí	sí	Incluye #AABBGGRR y #BBGGRR. Analizado en una cadena de color CSS
colorMode	sí	no
coordinates	sí	sí
Data	sí	sí
description	sí	sí
displayName	sí	sí
Document	sí	sí
drawOrder	partial	no	Se lee para las superposiciones de suelo y se usa para ordenarlas.
east	sí	sí
end	sí	sí
ExtendedData	sí	sí	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	sí	sí
Folder	sí	sí
GroundOverlay	sí	sí	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	sí	partial	Solo escribe si los datos se almacenan en la propiedad de la forma. Las unidades se configuran solo como "píxeles".
href	sí	sí
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	sí	sí
kml	sí	sí
LabelStyle	no	no
LatLonBox	sí	sí
gx:LatLonQuad	sí	sí
LinearRing	sí	sí
LineString	sí	sí
LineStyle	sí	sí	colorMode no se admite.
Link	sí	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	sí	sí
NetworkLink	sí	no	Los vínculos deben estar en el mismo dominio que el documento.
NetworkLinkControl	no	no
north	sí	sí
open	sí	sí
outerBoundaryIs	sí	sí
outline	sí	sí
overlayXY	no	no
Pair	partial	no	Solo se admite el estilo normal en un StyleMap. highlight no se admite.
phoneNumber	sí	sí
PhotoOverlay	no	no
Placemark	sí	sí
Point	sí	sí
Polygon	sí	sí
PolyStyle	sí	sí
Region	partial	partial	LatLongBox se admite en el nivel de documento.
rotation	no	no
rotationXY	no	no
scale	no	no
Schema	sí	sí
SchemaData	sí	sí
schemaUrl	partial	sí	No admite la carga de estilos de documentos externos que no están incluidos en una KMZ.
ScreenOverlay	no	no
screenXY	no	no
SimpleData	sí	sí
SimpleField	sí	sí
size	no	no
Snippet	partial	partial	El atributo maxLines se omite.
south	sí	sí
Style	sí	sí
StyleMap	partial	no	Solo se admite el estilo normal en un StyleMap.
styleUrl	partial	sí	No se admiten direcciones URL de estilo externo.
text	sí	sí	No se admite la sustitución de $[geDirections]
textColor	sí	sí
TimeSpan	sí	sí
TimeStamp	sí	sí
value	sí	sí
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	sí	sí
west	sí	sí
when	sí	sí
width	sí	sí

Elementos GeoRSS

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

Nombre del elemento	Lectura	Escritura	Notas
atom:author	sí	sí
atom:category	sí	sí
atom:content	sí	sí
atom:contributor	sí	sí
atom:email	sí	sí
atom:entry	sí	sí
atom:feed	sí	sí
atom:icon	sí	sí
atom:id	sí	sí
atom:link	sí	sí
atom:logo	sí	sí
atom:name	sí	sí
atom:published	sí	sí
atom:rights	sí	sí
atom:source	sí	sí
atom:subtitle	sí	sí
atom:summary	sí	sí
atom:title	sí	sí
atom:updated	sí	sí
atom:uri	sí	sí
geo:lat	sí	no	Se escribe como un georss:point.
geo:lon	sí	no	Se escribe como un georss:point.
geo:long	sí	no	Se escribe como un georss:point.
georss:box	sí	no	Se lee como un polígono y se le asigna una propiedad subType de "Rectangle".
georss:circle	sí	sí
georss:elev	sí	sí
georss:featurename	sí	sí
georss:featuretypetag	sí	sí
georss:floor	sí	sí
georss:line	sí	sí
georss:point	sí	sí
georss:polygon	sí	sí
georss:radius	sí	sí
georss:relationshiptag	sí	sí
georss:where	sí	sí
geourl:latitude	sí	no	Se escribe como un georss:point.
geourl:longitude	sí	no	Se escribe como un georss:point.
position	sí	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	sí	no	GeoRSS escrito en formato ATOM.
rss:author	sí	partial	Se escribe como un atom:author.
rss:category	sí	partial	Se escribe como un atom:category.
rss:channel	sí	no
rss:cloud	sí	no
rss:comments	sí	no
rss:copyright	sí	partial	Se escribe como un atom:rights si la forma no tiene ya una propiedad de tipo rightsproperties.
rss:description	sí	partial	Se escribe como un atom:content si la forma no tiene ya una propiedad de tipo contentproperties.
rss:docs	sí	no
rss:enclosure	sí	no
rss:generator	sí	no
rss:guid	sí	partial	Se escribe como un atom:id si la forma no tiene ya una propiedad de tipo idproperties.
rss:image	sí	partial	Se escribe como un atom:logo si la forma no tiene ya una propiedad de tipo logoproperties.
rss:item	sí	partial	Se escribe como un atom:entry.
rss:language	sí	no
rss:lastBuildDate	sí	partial	Se escribe como un atom:updated si la forma no tiene ya una propiedad de tipo updatedproperties.
rss:link	sí	partial	Se escribe como un atom:link.
rss:managingEditor	sí	partial	Se escribe como un atom:contributor.
rss:pubDate	sí	partial	Se escribe como un atom:published si la forma no tiene ya una propiedad de tipo publishedproperties.
rss:rating	sí	no
rss:skipDays	sí	no
rss:skipHours	sí	no
rss:source	sí	partial	Se escribe como un atom:source que contiene un atom:link.
rss:textInput	sí	no
rss:title	sí	partial	Se escribe como un atom:title.
rss:ttl	sí	no
rss:webMaster	sí	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	sí	no	Se escribe como gml:posList.
gml:curveMember	sí	no
gml:curveMembers	sí	no
gml:Box	sí	no	Se escribe como gml:Envelope.
gml:description	sí	sí
gml:Envelope	sí	sí
gml:exterior	sí	sí
gml:Feature	sí	no	Se escribe como una forma.
gml:FeatureCollection	sí	no	Se escribe como una colección Geometry.
gml:featureMember	sí	no	Se escribe como una colección Geometry.
gml:geometry	sí	no	Se escribe como una forma.
gml:geometryMember	sí	sí
gml:geometryMembers	sí	sí
gml:identifier	sí	sí
gml:innerBoundaryIs	sí	no	Se escribe con gml.interior.
gml:interior	sí	sí
gml:LinearRing	sí	sí
gml:LineString	sí	sí
gml:lineStringMember	sí	sí
gml:lineStringMembers	sí	no
gml:MultiCurve	sí	no	Solo lee miembros gml:LineString. Se escribe como gml.MultiLineString
gml:MultiGeometry	partial	partial	Solo se lee como FeatureCollection.
gml:MultiLineString	sí	sí
gml:MultiPoint	sí	sí
gml:MultiPolygon	sí	sí
gml:MultiSurface	sí	no	Solo lee miembros gml:Polygon. Se escribe como gml.MultiPolygon
gml:name	sí	sí
gml:outerBoundaryIs	sí	no	Se escribe con gml.exterior.
gml:Point	sí	sí
gml:pointMember	sí	sí
gml:pointMembers	sí	no
gml:Polygon	sí	sí
gml:polygonMember	sí	sí
gml:polygonMembers	sí	no
gml:pos	sí	sí
gml:posList	sí	sí
gml:surfaceMember	sí	sí

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	sí	sí
gpx:author	sí	sí
gpx:bounds	sí	sí	Se convierte en un LocationRect cuando se lee.
gpx:cmt	sí	sí
gpx:copyright	sí	sí
gpx:desc	sí	sí	Se copia en una propiedad description cuando la lectura se alinea con otros formatos XML.
gpx:dgpsid	sí	sí
gpx:ele	sí	sí
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	sí	sí
gpx:gpx	sí	sí
gpx:hdop	sí	sí
gpx:link	sí	sí
gpx:magvar	sí	sí
gpx:metadata	sí	sí
gpx:name	sí	sí
gpx:pdop	sí	sí
gpx:rte	sí	sí
gpx:rtept	sí	sí
gpx:sat	sí	sí
gpx:src	sí	sí
gpx:sym	sí	sí	Se captura el valor, pero no se usa para modificar el icono de alfiler.
gpx:text	sí	sí
gpx:time	sí	sí
gpx:trk	sí	sí
gpx:trkpt	sí	sí
gpx:trkseg	sí	sí
gpx:type	sí	sí
gpx:vdop	sí	sí
gpx:wpt	sí	sí
gpx_style:color	sí	sí
gpx_style:line	partial	partial	Se admiten color, opacity, width y lineCap.
gpx_style:opacity	sí	sí
gpx_style:width	sí	sí
gpxx:DisplayColor	sí	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	sí	sí
gpx:fix	sí	sí

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