Podrobnosti o podporovaných formátech dat
Tento článek obsahuje specifika podpory čtení a zápisu pro všechny značky XML a dobře známé typy geometrie textu. Také podrobně popisuje, jak se oddělená prostorová data analyzují v modulu prostorových vstupně-výstupních operací.
Podporované obory názvů XML
Modul prostorových vstupně-výstupních operací podporuje značky XML z následujících oborů názvů.
| Předpona oboru názvů | Identifikátor URI oboru názvů | Notes |
|---|---|---|
atom |
http://www.w3.org/2005/Atom |
|
geo |
http://www.w3.org/2003/01/geo/wgs84_pos# |
Podpora jen pro čtení v souborech GeoRSS |
georss |
http://www.georss.org/georss |
|
geourl |
http://geourl.org/rss/module/ |
Podpora jen pro čtení v souborech GeoRSS |
gml |
http://www.opengis.net/gml |
|
gpx |
http://www.topografix.com/GPX/1/1 |
|
gpxx |
http://www.garmin.com/xmlschemas/GpxExtensions/v3 |
Podpora jen pro čtení v souborech GPX Parsuje a používá DisplayColor. Všechny ostatní vlastnosti přidané do metadat obrazce |
gpx_style |
http://www.topografix.com/GPX/gpx_style/0/2 |
Podporováno v souborech GPX. Používá barvu čáry. |
gx |
http://www.google.com/kml/ext/2.2 |
|
kml |
http://www.opengis.net/kml/2.2 |
|
rss |
Jen pro čtení. GeoRSS zapisuje pomocí formátu Atom. |
Podporované elementy XML
Modul prostorových vstupně-výstupních operací podporuje následující elementy XML. Všechny značky XML, které nejsou podporovány, se převedou na objekt JSON. Každá značka se pak přidá jako vlastnost v properties poli nadřazeného obrazce nebo vrstvy.
Elementy KML
Prostorový vstupně-výstupní modul podporuje následující prvky KML.
| Název prvku | Čtení | Zápis | Notes |
|---|---|---|---|
address |
partial | ano | Objekt se analyzuje, ale nepoužívá se k umístění obrazce. |
AddressDetails |
partial | ne | Objekt se analyzuje, ale nepoužívá se k umístění obrazce. |
atom:author |
ano | ano | |
atom:link |
ano | ano | |
atom:name |
ano | ano | |
BalloonStyle |
partial | partial | displayMode není podporováno. Převedeno na .PopupTemplate Pokud chcete napsat, přidejte popupTemplate vlastnost jako vlastnost funkce, pro kterou ji chcete napsat. |
begin |
ano | ano | |
color |
ano | ano | Zahrnuje #AABBGGRR a #BBGGRR. Parsováno do barevného řetězce CSS |
colorMode |
ano | ne | |
coordinates |
ano | ano | |
Data |
ano | ano | |
description |
ano | ano | |
displayName |
ano | ano | |
Document |
ano | ano | |
drawOrder |
partial | ne | Čte se pro překryvné vrstvy země a slouží k jejich řazení. |
east |
ano | ano | |
end |
ano | ano | |
ExtendedData |
ano | ano | Podporuje netypové DataSimpleData nebo Schemaa nahrazení entit formuláře $[dataName]. |
extrude |
partial | partial | Podporováno pouze pro mnohoúhelníky. MultiGeometrie, které mají mnohoúhelníky různých výšek, jsou rozděleny do jednotlivých vlastností. Styly čar nejsou podporované. Mnohoúhelníky s výškou 0 se vykreslují jako plochý mnohoúhelník. Při čtení se výška první souřadnice vnějšího kruhu přidá jako vlastnost výšky mnohoúhelníku. Pak se k vykreslení mnohoúhelníku na mapě použije výška první souřadnice. |
fill |
ano | ano | |
Folder |
ano | ano | |
GroundOverlay |
ano | ano | color není podporováno. |
heading |
partial | ne | Parsované, ale nevykreslované pomocí SimpleDataLayer. Zapisuje se pouze v případě, že jsou data uložena ve vlastnosti obrazce. |
hotSpot |
ano | partial | Zapisuje se pouze v případě, že jsou data uložena ve vlastnosti obrazce. Jednotky se vydají jenom jako "pixely". |
href |
ano | ano | |
Icon |
partial | partial | Parsované, ale nevykreslované pomocí SimpleDataLayer. Zapíše vlastnost ikony obrazce pouze v případě, že obsahuje data identifikátoru URI. Podporuje se jen href. |
IconStyle |
partial | partial | icon, , headingcolorModea hotspots hodnoty jsou analyzovány, ale nejsou vykresleny pomocíSimpleDataLayer |
innerBoundaryIs |
ano | ano | |
kml |
ano | ano | |
LabelStyle |
ne | ne | |
LatLonBox |
ano | ano | |
gx:LatLonQuad |
ano | ano | |
LinearRing |
ano | ano | |
LineString |
ano | ano | |
LineStyle |
ano | ano | colorMode není podporováno. |
Link |
ano | ne | href U síťových propojení se podporuje pouze vlastnost. |
MultiGeometry |
partial | partial | Při čtení se můžou rozdělit na jednotlivé funkce. |
name |
ano | ano | |
NetworkLink |
ano | ne | Odkazy musí být ve stejné doméně jako dokument. |
NetworkLinkControl |
ne | ne | |
north |
ano | ano | |
open |
ano | ano | |
outerBoundaryIs |
ano | ano | |
outline |
ano | ano | |
overlayXY |
ne | ne | |
Pair |
partial | ne | Podporuje se normal pouze styl v souboru StyleMap . highlight není podporováno. |
phoneNumber |
ano | ano | |
PhotoOverlay |
ne | ne | |
Placemark |
ano | ano | |
Point |
ano | ano | |
Polygon |
ano | ano | |
PolyStyle |
ano | ano | |
Region |
partial | partial | LatLongBox se podporuje na úrovni dokumentu. |
rotation |
ne | ne | |
rotationXY |
ne | ne | |
scale |
ne | ne | |
Schema |
ano | ano | |
SchemaData |
ano | ano | |
schemaUrl |
partial | ano | Nepodporuje načítání stylů z externích dokumentů, které nejsou součástí KmZ. |
ScreenOverlay |
ne | ne | |
screenXY |
ne | ne | |
SimpleData |
ano | ano | |
SimpleField |
ano | ano | |
size |
ne | ne | |
Snippet |
partial | partial | maxLines atribut je ignorován. |
south |
ano | ano | |
Style |
ano | ano | |
StyleMap |
partial | ne | Podporuje se pouze normální styl.StyleMap |
styleUrl |
partial | ano | Adresy URL externího stylu se nepodporují. |
text |
ano | ano | $[geDirections] Nahrazení není podporováno. |
textColor |
ano | ano | |
TimeSpan |
ano | ano | |
TimeStamp |
ano | ano | |
value |
ano | ano | |
viewRefreshMode |
partial | ne | Pokud odkazujete na službu WMS, podporuje se pouze onStop překrytí země. BBOX={bboxWest},{bboxSouth},{bboxEast},{bboxNorth} Připojí se k adrese URL a při přesouvání mapy se aktualizuje. |
visibility |
ano | ano | |
west |
ano | ano | |
when |
ano | ano | |
width |
ano | ano |
Prvky GeoRSS
Prostorový vstupně-výstupní modul podporuje následující prvky GeoRSS.
| Název prvku | Čtení | Zápis | Notes |
|---|---|---|---|
atom:author |
ano | ano | |
atom:category |
ano | ano | |
atom:content |
ano | ano | |
atom:contributor |
ano | ano | |
atom:email |
ano | ano | |
atom:entry |
ano | ano | |
atom:feed |
ano | ano | |
atom:icon |
ano | ano | |
atom:id |
ano | ano | |
atom:link |
ano | ano | |
atom:logo |
ano | ano | |
atom:name |
ano | ano | |
atom:published |
ano | ano | |
atom:rights |
ano | ano | |
atom:source |
ano | ano | |
atom:subtitle |
ano | ano | |
atom:summary |
ano | ano | |
atom:title |
ano | ano | |
atom:updated |
ano | ano | |
atom:uri |
ano | ano | |
geo:lat |
ano | ne | Napsané jako georss:point. |
geo:lon |
ano | ne | Napsané jako georss:point. |
geo:long |
ano | ne | Napsané jako georss:point. |
georss:box |
ano | ne | Číst jako mnohoúhelník a přidělovat subType vlastnost "Rectangle" |
georss:circle |
ano | ano | |
georss:elev |
ano | ano | |
georss:featurename |
ano | ano | |
georss:featuretypetag |
ano | ano | |
georss:floor |
ano | ano | |
georss:line |
ano | ano | |
georss:point |
ano | ano | |
georss:polygon |
ano | ano | |
georss:radius |
ano | ano | |
georss:relationshiptag |
ano | ano | |
georss:where |
ano | ano | |
geourl:latitude |
ano | ne | Napsané jako georss:point. |
geourl:longitude |
ano | ne | Napsané jako georss:point. |
position |
ano | ne | Některé informační kanály XML zabalí GML značkou pozice místo toho, aby je zabalily značkou georss:where . Tuto značku si můžete přečíst, ale zapisuje se pomocí georss:where značky. |
rss |
ano | ne | GeoRSS napsané ve formátu ATOM |
rss:author |
ano | partial | Napsané jako .atom:author |
rss:category |
ano | partial | Napsané jako .atom:category |
rss:channel |
ano | ne | |
rss:cloud |
ano | ne | |
rss:comments |
ano | ne | |
rss:copyright |
ano | partial | Zapisuje se jako obrazec atom:rights , pokud ještě nemá rights properties vlastnost. |
rss:description |
ano | partial | Zapisuje se jako obrazec atom:content , pokud ještě nemá content properties vlastnost. |
rss:docs |
ano | ne | |
rss:enclosure |
ano | ne | |
rss:generator |
ano | ne | |
rss:guid |
ano | partial | Zapisuje se jako obrazec atom:id , pokud ještě nemá id properties vlastnost. |
rss:image |
ano | partial | Zapisuje se jako obrazec atom:logo , pokud ještě nemá logo properties vlastnost. |
rss:item |
ano | partial | Napsané jako .atom:entry |
rss:language |
ano | ne | |
rss:lastBuildDate |
ano | partial | Zapisuje se jako obrazec atom:updated , pokud ještě nemá updated properties vlastnost. |
rss:link |
ano | partial | Napsané jako .atom:link |
rss:managingEditor |
ano | partial | Napsané jako .atom:contributor |
rss:pubDate |
ano | partial | Zapisuje se jako obrazec atom:published , pokud ještě nemá published properties vlastnost. |
rss:rating |
ano | ne | |
rss:skipDays |
ano | ne | |
rss:skipHours |
ano | ne | |
rss:source |
ano | partial | Napsané jako atom:source obsahující .atom:link |
rss:textInput |
ano | ne | |
rss:title |
ano | partial | Napsané jako .atom:title |
rss:ttl |
ano | ne | |
rss:webMaster |
ano | ne |
Prvky GML
Prostorový vstupně-výstupní modul podporuje následující prvky GML.
| Název prvku | Čtení | Zápis | Notes |
|---|---|---|---|
gml:coordinates |
ano | ne | Napsané jako gml:posList. |
gml:curveMember |
ano | ne | |
gml:curveMembers |
ano | ne | |
gml:Box |
ano | ne | Napsané jako gml:Envelope. |
gml:description |
ano | ano | |
gml:Envelope |
ano | ano | |
gml:exterior |
ano | ano | |
gml:Feature |
ano | ne | Zapisuje se jako obrazec. |
gml:FeatureCollection |
ano | ne | Napsali jsme jako geometrii. |
gml:featureMember |
ano | ne | Napsali jsme jako geometrii. |
gml:geometry |
ano | ne | Zapisuje se jako obrazec. |
gml:geometryMember |
ano | ano | |
gml:geometryMembers |
ano | ano | |
gml:identifier |
ano | ano | |
gml:innerBoundaryIs |
ano | ne | Napsané pomocí gml.interior. |
gml:interior |
ano | ano | |
gml:LinearRing |
ano | ano | |
gml:LineString |
ano | ano | |
gml:lineStringMember |
ano | ano | |
gml:lineStringMembers |
ano | ne | |
gml:MultiCurve |
ano | ne | Jen čte gml:LineString členy. Napsané jako gml.MultiLineString |
gml:MultiGeometry |
partial | partial | Jen číst jako FeatureCollection. |
gml:MultiLineString |
ano | ano | |
gml:MultiPoint |
ano | ano | |
gml:MultiPolygon |
ano | ano | |
gml:MultiSurface |
ano | ne | Jen čte gml:Polygon členy. Napsané jako gml.MultiPolygon |
gml:name |
ano | ano | |
gml:outerBoundaryIs |
ano | ne | Napsané pomocí gml.exterior. |
gml:Point |
ano | ano | |
gml:pointMember |
ano | ano | |
gml:pointMembers |
ano | ne | |
gml:Polygon |
ano | ano | |
gml:polygonMember |
ano | ano | |
gml:polygonMembers |
ano | ne | |
gml:pos |
ano | ano | |
gml:posList |
ano | ano | |
gml:surfaceMember |
ano | ano |
Další poznámky
- Členové prvky jsou vyhledávány geometrii, která může být uložena v podřízených elementech. Tato vyhledávací operace je nezbytná, protože mnoho formátů XML, které se rozšiřují z GML, nemusí umístit geometrii jako přímé podřízené prvek členu.
srsNameje částečně podporován pro souřadnice WGS84 a následující kódy: EPSG:4326) a web Mercator (EPSG:3857 nebo jeden z jeho alternativních kódů. Jakýkoli jiný souřadnicový systém je analyzován jako WGS84 tak, jak je.- Pokud není při čtení informačního kanálu XML zadáno pořadí os, je určeno na základě tipů v informačním kanálu XML. Předvolba je uvedena pro pořadí osy "zeměpisná šířka, zeměpisná délka".
- Pokud není pro vlastnosti při zápisu do souboru GML zadán vlastní obor názvů GML, nepřidají se další informace o vlastnostech.
Prvky GPX
Modul prostorových vstupně-výstupních operací podporuje následující prvky GPX.
| Název prvku | Čtení | Zápis | Notes |
|---|---|---|---|
gpx:ageofdgpsdata |
ano | ano | |
gpx:author |
ano | ano | |
gpx:bounds |
ano | ano | Při čtení se převede na locationRect. |
gpx:cmt |
ano | ano | |
gpx:copyright |
ano | ano | |
gpx:desc |
ano | ano | Zkopírováno do vlastnosti popisu při čtení tak, aby odpovídalo jiným formátům XML. |
gpx:dgpsid |
ano | ano | |
gpx:ele |
ano | ano | |
gpx:extensions |
partial | partial | Při čtení se extrahují informace o stylu. Všechna ostatní rozšíření se zploštějí do jednoduchého objektu JSON. Zapisuje se jenom informace o stylu obrazce. |
gpx:geoidheight |
ano | ano | |
gpx:gpx |
ano | ano | |
gpx:hdop |
ano | ano | |
gpx:link |
ano | ano | |
gpx:magvar |
ano | ano | |
gpx:metadata |
ano | ano | |
gpx:name |
ano | ano | |
gpx:pdop |
ano | ano | |
gpx:rte |
ano | ano | |
gpx:rtept |
ano | ano | |
gpx:sat |
ano | ano | |
gpx:src |
ano | ano | |
gpx:sym |
ano | ano | Hodnota se zaznamenává, ale nepoužívá se ke změně ikony připínáku. |
gpx:text |
ano | ano | |
gpx:time |
ano | ano | |
gpx:trk |
ano | ano | |
gpx:trkpt |
ano | ano | |
gpx:trkseg |
ano | ano | |
gpx:type |
ano | ano | |
gpx:vdop |
ano | ano | |
gpx:wpt |
ano | ano | |
gpx_style:color |
ano | ano | |
gpx_style:line |
partial | partial | colorwidthlineCap, opacity, jsou podporovány. |
gpx_style:opacity |
ano | ano | |
gpx_style:width |
ano | ano | |
gpxx:DisplayColor |
ano | ne | Slouží k určení barvy obrazce. Pokud píšete, gpx_style:line použije se místo toho barva. |
gpxx:RouteExtension |
partial | ne | Všechny vlastnosti jsou načteny do properties. Používá se pouze DisplayColor . |
gpxx:TrackExtension |
partial | ne | Všechny vlastnosti jsou načteny do properties. Používá se pouze DisplayColor . |
gpxx:WaypointExtension |
partial | ne | Všechny vlastnosti jsou načteny do properties. Používá se pouze DisplayColor . |
gpx:keywords |
ano | ano | |
gpx:fix |
ano | ano |
Další poznámky
Při psaní;
- MultiPointy jsou rozdělené na jednotlivé body.
- Mnohoúhelníky a multipolygony jsou napsány jako stopy.
Podporované dobře známé typy geometrie textu
| Typ geometrie | Čtení | Zápis |
|---|---|---|
| BOD | linka | linka |
| BOD Z | linka | linka |
| POINT M | linka | x[2] |
| POINT ZM | x[1][2] | |
| LINESTRING | linka | linka |
| LINESTRING Z | linka | linka |
| LINESTRING M | linka | x[2] |
| LINESTRING ZM | x[1][2] | |
| MNOHOÚHELNÍK | linka | linka |
| POLYGON Z | linka | linka |
| POLYGON M | linka | x[2] |
| POLYGON ZM | x[1][2] | |
| MULTIPOINT | linka | linka |
| MULTIPOINT Z | linka | linka |
| MULTIPOINT M | linka | x[2] |
| POMULTIPOINTINT ZM | x[1][2] | |
| MULTILINESTRING | linka | linka |
| MULTILINESTRING Z | linka | linka |
| MULTILINESTRING M | linka | x[2] |
| MULTILINESTRING ZM | x[1][2] | |
| MULTIPOLYGON | linka | linka |
| MULTIPOLYGON Z | linka | linka |
| MULTIPOLYGON M | linka | x[2] |
| MULTIPOLYGON ZM | x[1][2] | |
| GEOMETRYCOLLECTION | linka | linka |
| GEOMETRYCOLLECTION Z | linka | linka |
| GEOMETRYCOLLECTION M | linka | x[2] |
| GEOMETRYCOLLECTION ZM | x[1][2] | linka |
[1] Zachytí se pouze parametr Z a přidá se jako třetí hodnota v hodnotě Position.
[2] Parametr M není zachycen.
Podpora prostorových dat s oddělovači
Prostorová data s oddělovači, jako jsou například soubory hodnot oddělených čárkami (CSV), často obsahují sloupce obsahující prostorová data. Může se například jednat o sloupce, které obsahují informace o zeměpisné šířce a délce. V dobře známém textovém formátu by mohl být sloupec, který obsahuje prostorová geometrické data.
Detekce prostorových dat ve sloupcích
Při čtení souboru s oddělovači, který obsahuje prostorová data, se hlavička analyzuje a určí, které sloupce obsahují pole umístění. Pokud záhlaví obsahuje informace o typu, použije se k přetypování hodnot buněk na příslušný typ. Pokud není zadáno žádné záhlaví, první řádek se analyzuje a vygeneruje záhlaví. Při analýze prvního řádku se provede kontrola tak, aby odpovídala názvům sloupců s následujícími názvy bez rozlišování malých a malých písmen. Pořadí názvů je prioritou v případě, že v souboru existují dva nebo více názvů.
Latitude
latitudelatlatddlat_ddlatitude83latdecdegyycenterpoint-y
Longitude
longitudelonlnglonglongddlong_ddlongitude83longdecdegxxcenterpoint-x
Elevation
elevationelvaltitudealtz
Zeměpisná oblast
První řádek dat se prohledává pro řetězce, které jsou ve známém textovém formátu.
Datové typy s oddělovači
Při skenování řádku záhlaví se extrahují všechny informace o typu, které jsou v názvu sloupce, a slouží k přetypování buněk v daném sloupci. Tady je příklad názvu sloupce, který má hodnotu typu ColumnName (typeName). Podporují se následující názvy typů bez rozlišování velkých a malých písmen:
Čísla
- edm.int64
- int
- long
- edm.double
- float (číslo s plovoucí řádovou čárkou)
- double
- Číslo
Logické hodnoty
- edm.boolean
- bool
- boolean
Kalendářní data
- edm.datetime
- datum
- datetime
Zeměpisná oblast
- edm.geography
- zeměpisné oblasti.
Řetězce
- edm.string
- varchar
- text
- string
Pokud se ze záhlaví nedají extrahovat žádné informace o typu a při čtení je povolená možnost dynamického psaní, pak se jednotlivé buňky analyzují a určují, jaký datový typ je nejvhodnější přetypovat jako.
Další kroky
Další ukázky kódu pro přidání do map najdete v následujících článcích: