تفاصيل تنسيق البيانات المدعومة
توفر هذه المقالة تفاصيل حول دعم القراءة والكتابة لكافة علامات تمييز XML وأنواع هندسة النص Well-Known. كما يوضح بالتفصيل كيفية تحليل البيانات المكانية المحددة في وحدة IO المكانية.
مساحات أسماء XML المدعومة
تدعم وحدة IO المكانية علامات تمييز XML من مساحات الأسماء التالية.
| بادئة مساحة الاسم | مساحة الاسم URI | ملاحظات |
|---|---|---|
atom |
http://www.w3.org/2005/Atom |
|
geo |
http://www.w3.org/2003/01/geo/wgs84_pos# |
اقرأ الدعم فقط في ملفات GeoRSS. |
georss |
http://www.georss.org/georss |
|
geourl |
http://geourl.org/rss/module/ |
اقرأ الدعم فقط في ملفات GeoRSS. |
gml |
http://www.opengis.net/gml |
|
gpx |
http://www.topografix.com/GPX/1/1 |
|
gpxx |
http://www.garmin.com/xmlschemas/GpxExtensions/v3 |
اقرأ الدعم فقط في ملفات GPX. يوزع ويستخدم DisplayColor. تمت إضافة جميع الخصائص الأخرى إلى بيانات تعريف الشكل. |
gpx_style |
http://www.topografix.com/GPX/gpx_style/0/2 |
مدعوم في ملفات GPX. يستخدم لون الخط. |
gx |
http://www.google.com/kml/ext/2.2 |
|
kml |
http://www.opengis.net/kml/2.2 |
|
rss |
قم بالقراءة فقط. يكتب GeoRSS باستخدام تنسيق Atom. |
عناصر XML المدعومة
تدعم وحدة IO المكانية عناصر XML التالية. سيتم تحويل أي علامات تمييز XML غير مدعومة إلى كائن JSON. بعد ذلك، ستتم إضافة كل علامة تمييز كخاصية في properties حقل الشكل أو الطبقة الأصل.
عناصر KML
تدعم وحدة IO المكانية عناصر KML التالية.
| اسم العنصر | قراءة | كتابة | ملاحظات |
|---|---|---|---|
address |
جزئي | نعم | يتم تحليل الكائن ولكن لا يتم استخدامه لتحديد موضع الشكل. |
AddressDetails |
جزئي | لا | يتم تحليل الكائن ولكن لا يتم استخدامه لتحديد موضع الشكل. |
atom:author |
نعم | نعم | |
atom:link |
نعم | نعم | |
atom:name |
نعم | نعم | |
BalloonStyle |
جزئي | جزئي | displayMode غير مدعوم. تم التحويل إلى ملف PopupTemplate. للكتابة، أضف خاصية كخاصية popupTemplate للميزة التي تريد كتابتها لها. |
begin |
نعم | نعم | |
color |
نعم | نعم | يتضمن #AABBGGRR و #BBGGRR. تم تحليلها إلى سلسلة ألوان CSS |
colorMode |
نعم | لا | |
coordinates |
نعم | نعم | |
Data |
نعم | نعم | |
description |
نعم | نعم | |
displayName |
نعم | نعم | |
Document |
نعم | نعم | |
drawOrder |
جزئي | لا | اقرأ عن التراكبات الأرضية واستخدمها لفرزها. |
east |
نعم | نعم | |
end |
نعم | نعم | |
ExtendedData |
نعم | نعم | يدعم عمليات استبدال النموذج $[dataName]غير المكتوبة DataSimpleData أو Schemaأو الكيان . |
extrude |
جزئي | جزئي | مدعوم فقط للمضلعات. سيتم تقسيم MultiGeometry التي تحتوي على مضلعات ذات ارتفاعات مختلفة إلى ميزات فردية. أنماط الأسطر غير مدعومة. سيتم تقديم المضلعات التي يبلغ ارتفاعها 0 كمضلع مسطح. عند القراءة ، سيتم إضافة ارتفاع الإحداثي الأول في الحلقة الخارجية كخاصية ارتفاع للمضلع. بعد ذلك، سيتم استخدام ارتفاع الإحداثي الأول لعرض المضلع على الخريطة. |
fill |
نعم | نعم | |
Folder |
نعم | نعم | |
GroundOverlay |
نعم | نعم | color غير مدعوم |
heading |
جزئي | لا | تم تحليلها ولكن لم يتم تقديمها بواسطة SimpleDataLayer. يكتب فقط إذا تم تخزين البيانات في خاصية الشكل. |
hotSpot |
نعم | جزئي | يكتب فقط إذا تم تخزين البيانات في خاصية الشكل. يتم إخراج الوحدات ك "بكسل" فقط. |
href |
نعم | نعم | |
Icon |
جزئي | جزئي | تم تحليلها ولكن لم يتم تقديمها بواسطة SimpleDataLayer. لا تكتب خاصية أيقونة الشكل إلا إذا كانت تحتوي على بيانات URI. يتم دعم href فقط. |
IconStyle |
جزئي | جزئي | icon، ، colorModeويتم hotspots تحليل القيم، headingولكن لا يتم تقديمها بواسطةSimpleDataLayer |
innerBoundaryIs |
نعم | نعم | |
kml |
نعم | نعم | |
LabelStyle |
لا | لا | |
LatLonBox |
نعم | نعم | |
gx:LatLonQuad |
نعم | نعم | |
LinearRing |
نعم | نعم | |
LineString |
نعم | نعم | |
LineStyle |
نعم | نعم | colorMode غير مدعوم. |
Link |
نعم | لا | الخاصية href فقط مدعومة لارتباطات الشبكة. |
MultiGeometry |
جزئي | جزئي | يمكن تقسيمها إلى ميزات فردية عند قراءتها. |
name |
نعم | نعم | |
NetworkLink |
نعم | لا | يجب أن تكون الروابط على نفس نطاق المستند. |
NetworkLinkControl |
لا | لا | |
north |
نعم | نعم | |
open |
نعم | نعم | |
outerBoundaryIs |
نعم | نعم | |
outline |
نعم | نعم | |
overlayXY |
لا | لا | |
Pair |
جزئي | لا | normal يتم دعم النمط الموجود في a StyleMap فقط. highlight غير مدعوم. |
phoneNumber |
نعم | نعم | |
PhotoOverlay |
لا | لا | |
Placemark |
نعم | نعم | |
Point |
نعم | نعم | |
Polygon |
نعم | نعم | |
PolyStyle |
نعم | نعم | |
Region |
جزئي | جزئي | LatLongBox مدعوم على مستوى المستند. |
rotation |
لا | لا | |
rotationXY |
لا | لا | |
scale |
لا | لا | |
Schema |
نعم | نعم | |
SchemaData |
نعم | نعم | |
schemaUrl |
جزئي | نعم | لا يدعم تحميل الأنماط من المستندات الخارجية غير المضمنة في KMZ. |
ScreenOverlay |
لا | لا | |
screenXY |
لا | لا | |
SimpleData |
نعم | نعم | |
SimpleField |
نعم | نعم | |
size |
لا | لا | |
Snippet |
جزئي | جزئي | maxLines يتم تجاهل السمة. |
south |
نعم | نعم | |
Style |
نعم | نعم | |
StyleMap |
جزئي | لا | يتم دعم النمط العادي فقط في a StyleMap . |
styleUrl |
جزئي | نعم | عناوين URL ذات الأنماط الخارجية غير مدعومة. |
text |
نعم | نعم | استبدال $[geDirections] غير مدعوم |
textColor |
نعم | نعم | |
TimeSpan |
نعم | نعم | |
TimeStamp |
نعم | نعم | |
value |
نعم | نعم | |
viewRefreshMode |
جزئي | لا | إذا كنت تشير إلى خدمة WMS ، دعمها فقط onStop للتراكبات الأرضية. سيتم إلحاقه BBOX={bboxWest},{bboxSouth},{bboxEast},{bboxNorth} بعنوان URL وتحديثه مع تحرك الخريطة. |
visibility |
نعم | نعم | |
west |
نعم | نعم | |
when |
نعم | نعم | |
width |
نعم | نعم |
عناصر GeoRSS
تدعم وحدة IO المكانية عناصر GeoRSS التالية.
| اسم العنصر | قراءة | كتابة | ملاحظات |
|---|---|---|---|
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 |
نعم | لا | مكتوب ك georss:point. |
geo:lon |
نعم | لا | مكتوب ك georss:point. |
geo:long |
نعم | لا | مكتوب ك georss:point. |
georss:box |
نعم | لا | اقرأ كمضلع وأعطيت خاصية subType "مستطيل" |
georss:circle |
نعم | نعم | |
georss:elev |
نعم | نعم | |
georss:featurename |
نعم | نعم | |
georss:featuretypetag |
نعم | نعم | |
georss:floor |
نعم | نعم | |
georss:line |
نعم | نعم | |
georss:point |
نعم | نعم | |
georss:polygon |
نعم | نعم | |
georss:radius |
نعم | نعم | |
georss:relationshiptag |
نعم | نعم | |
georss:where |
نعم | نعم | |
geourl:latitude |
نعم | لا | مكتوب ك georss:point. |
geourl:longitude |
نعم | لا | مكتوب ك georss:point. |
position |
نعم | لا | ستقوم بعض خلاصات XML بلف GML بعلامة موضع بدلا من لفها بعلامة georss:where تمييز. سوف يقرأ هذه العلامة ، ولكن سوف يكتب باستخدام علامة georss:where . |
rss |
نعم | لا | GeoRSS مكتوبة بتنسيق ATOM. |
rss:author |
نعم | جزئي | مكتوب ك atom:author. |
rss:category |
نعم | جزئي | مكتوب ك atom:category. |
rss:channel |
نعم | لا | |
rss:cloud |
نعم | لا | |
rss:comments |
نعم | لا | |
rss:copyright |
نعم | جزئي | مكتوب كشكل atom:rights إذا لم يكن له خاصية rightsproperties بالفعل. |
rss:description |
نعم | جزئي | مكتوب كشكل atom:content إذا لم يكن له خاصية contentproperties بالفعل. |
rss:docs |
نعم | لا | |
rss:enclosure |
نعم | لا | |
rss:generator |
نعم | لا | |
rss:guid |
نعم | جزئي | مكتوب كشكل atom:id إذا لم يكن يحتوي على خاصية idproperties بالفعل. |
rss:image |
نعم | جزئي | مكتوب كشكل atom:logo إذا لم يكن له خاصية logoproperties بالفعل. |
rss:item |
نعم | جزئي | مكتوب ك atom:entry. |
rss:language |
نعم | لا | |
rss:lastBuildDate |
نعم | جزئي | مكتوب كشكل atom:updated إذا لم يكن يحتوي على خاصية updatedproperties بالفعل. |
rss:link |
نعم | جزئي | مكتوب ك atom:link. |
rss:managingEditor |
نعم | جزئي | مكتوب ك atom:contributor. |
rss:pubDate |
نعم | جزئي | مكتوب كشكل atom:published إذا لم يكن له خاصية publishedproperties بالفعل. |
rss:rating |
نعم | لا | |
rss:skipDays |
نعم | لا | |
rss:skipHours |
نعم | لا | |
rss:source |
نعم | جزئي | مكتوب كحرف atom:source يحتوي على atom:link. |
rss:textInput |
نعم | لا | |
rss:title |
نعم | جزئي | مكتوب ك atom:title. |
rss:ttl |
نعم | لا | |
rss:webMaster |
نعم | لا |
عناصر GML
تدعم وحدة IO المكانية عناصر GML التالية.
| اسم العنصر | قراءة | كتابة | ملاحظات |
|---|---|---|---|
gml:coordinates |
نعم | لا | مكتوب ك gml:posList. |
gml:curveMember |
نعم | لا | |
gml:curveMembers |
نعم | لا | |
gml:Box |
نعم | لا | مكتوب ك gml:Envelope. |
gml:description |
نعم | نعم | |
gml:Envelope |
نعم | نعم | |
gml:exterior |
نعم | نعم | |
gml:Feature |
نعم | لا | مكتوب كشكل. |
gml:FeatureCollection |
نعم | لا | كتبت كمجموعة هندسية. |
gml:featureMember |
نعم | لا | كتبت كمجموعة هندسية. |
gml:geometry |
نعم | لا | مكتوب كشكل. |
gml:geometryMember |
نعم | نعم | |
gml:geometryMembers |
نعم | نعم | |
gml:identifier |
نعم | نعم | |
gml:innerBoundaryIs |
نعم | لا | مكتوب باستخدام gml.interior. |
gml:interior |
نعم | نعم | |
gml:LinearRing |
نعم | نعم | |
gml:LineString |
نعم | نعم | |
gml:lineStringMember |
نعم | نعم | |
gml:lineStringMembers |
نعم | لا | |
gml:MultiCurve |
نعم | لا | يقرأ gml:LineString الأعضاء فقط. مكتوب على النحو التالي gml.MultiLineString |
gml:MultiGeometry |
جزئي | جزئي | اقرأ فقط كمجموعة ميزات. |
gml:MultiLineString |
نعم | نعم | |
gml:MultiPoint |
نعم | نعم | |
gml:MultiPolygon |
نعم | نعم | |
gml:MultiSurface |
نعم | لا | يقرأ gml:Polygon الأعضاء فقط. مكتوب على النحو التالي gml.MultiPolygon |
gml:name |
نعم | نعم | |
gml:outerBoundaryIs |
نعم | لا | مكتوب باستخدام gml.exterior. |
gml:Point |
نعم | نعم | |
gml:pointMember |
نعم | نعم | |
gml:pointMembers |
نعم | لا | |
gml:Polygon |
نعم | نعم | |
gml:polygonMember |
نعم | نعم | |
gml:polygonMembers |
نعم | لا | |
gml:pos |
نعم | نعم | |
gml:posList |
نعم | نعم | |
gml:surfaceMember |
نعم | نعم |
ملاحظات إضافية
- سيتم البحث عن العناصر الأعضاء عن هندسة قد تكون مدفونة داخل العناصر الفرعية. عملية البحث هذه ضرورية لأن العديد من تنسيقات XML التي تمتد من GML قد لا تضع هندسة كتابع مباشر لعنصر عضو.
srsNameمدعوم جزئيا لإحداثيات WGS84 والرموز التالية: EPSG:4326)، و Web Mercator (EPSG:3857 أو أحد الرموز البديلة الخاصة به. سيتم تحليل أي نظام إحداثي آخر على أنه WGS84 كما هو.- ما لم يتم تحديده عند قراءة موجز XML، يتم تحديد ترتيب المحور استنادا إلى تلميحات في موجز XML. يتم إعطاء الأفضلية لترتيب محور "خط العرض وخط الطول".
- ما لم يتم تحديد مساحة اسم GML مخصصة للخصائص عند الكتابة إلى ملف GML، لن تتم إضافة معلومات إضافية عن الخصائص.
عناصر GPX
تدعم وحدة IO المكانية عناصر GPX التالية.
| اسم العنصر | قراءة | كتابة | ملاحظات |
|---|---|---|---|
gpx:ageofdgpsdata |
نعم | نعم | |
gpx:author |
نعم | نعم | |
gpx:bounds |
نعم | نعم | تم تحويلها إلى LocationRect عند قراءتها. |
gpx:cmt |
نعم | نعم | |
gpx:copyright |
نعم | نعم | |
gpx:desc |
نعم | نعم | يتم نسخها إلى خاصية وصف عند قراءتها لمحاذاة تنسيقات XML الأخرى. |
gpx:dgpsid |
نعم | نعم | |
gpx:ele |
نعم | نعم | |
gpx:extensions |
جزئي | جزئي | عند القراءة، يتم استخراج معلومات النمط. سيتم تسطيح جميع الملحقات الأخرى إلى كائن JSON بسيط. تتم كتابة معلومات نمط الشكل فقط. |
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 |
نعم | نعم | يتم التقاط القيمة، ولكن لا يتم استخدامها لتغيير رمز الدبوس. |
gpx:text |
نعم | نعم | |
gpx:time |
نعم | نعم | |
gpx:trk |
نعم | نعم | |
gpx:trkpt |
نعم | نعم | |
gpx:trkseg |
نعم | نعم | |
gpx:type |
نعم | نعم | |
gpx:vdop |
نعم | نعم | |
gpx:wpt |
نعم | نعم | |
gpx_style:color |
نعم | نعم | |
gpx_style:line |
جزئي | جزئي | color، opacity، ، lineCapwidthمدعومة. |
gpx_style:opacity |
نعم | نعم | |
gpx_style:width |
نعم | نعم | |
gpxx:DisplayColor |
نعم | لا | يستخدم لتحديد لون الشكل. عند الكتابة ، gpx_style:line سيتم استخدام اللون بدلا من ذلك. |
gpxx:RouteExtension |
جزئي | لا | تتم قراءة جميع الخصائص في properties. DisplayColor يتم استخدامه فقط. |
gpxx:TrackExtension |
جزئي | لا | تتم قراءة جميع الخصائص في properties. DisplayColor يتم استخدامه فقط. |
gpxx:WaypointExtension |
جزئي | لا | تتم قراءة جميع الخصائص في properties. DisplayColor يتم استخدامه فقط. |
gpx:keywords |
نعم | نعم | |
gpx:fix |
نعم | نعم |
ملاحظات إضافية
عند الكتابة;
- سيتم تقسيم النقاط المتعددة إلى نقاط طريق فردية.
- ستتم كتابة المضلعات والمضلعات المتعددة كمسارات.
أنواع هندسة النص Well-Known المعتمدة
| نوع الهندسة | قراءة | كتابة |
|---|---|---|
| نقطة | x | x |
| النقطة Z | x | x |
| بوينت إم | x | x[2] |
| بوينت ZM | x[1][2] | |
| سلسلة السطر | x | x |
| LINESTRING Z | x | x |
| LINESTRING M | x | x[2] |
| LINESTRING ZM | x[1][2] | |
| مضلع | x | x |
| مضلع Z | x | x |
| مضلع M | x | x[2] |
| مضلع ZM | x[1][2] | |
| متعدد النقاط | x | x |
| متعدد النقاط Z | x | x |
| متعدد النقاط M | x | x[2] |
| POMULTIPOINTINT ZM | x[1][2] | |
| سلسلة متعددة الأسطر | x | x |
| سلسلة متعددة الخطوط Z | x | x |
| سلسلة متعددة الأسطر M | x | x[2] |
| سلسلة متعددة الخطوط ZM | x[1][2] | |
| مضلع متعدد | x | x |
| مضلع متعدد Z | x | x |
| مضلع متعدد M | x | x[2] |
| مضلع متعدد ZM | x[1][2] | |
| مجموعة الهندسة | x | x |
| مجموعة الهندسة Z | x | x |
| مجموعة الهندسة M | x | x[2] |
| مجموعة الهندسة ZM | x[1][2] | x |
[1] يتم التقاط المعلمة Z فقط وإضافتها كقيمة ثالثة في قيمة الموضع.
[2 ] لم يتم التقاط المعلمة M.
دعم البيانات المكانية المحددة
غالبا ما تحتوي البيانات المكانية المحددة، مثل ملفات القيم المفصولة بفواصل (CSV)، على أعمدة تحتوي على بيانات مكانية. على سبيل المثال، قد تكون هناك أعمدة تحتوي على معلومات خطوط الطول والعرض. في تنسيق النص Well-Known، قد يكون هناك عمود يحتوي على بيانات الهندسة المكانية.
الكشف عن عمود البيانات المكانية
عند قراءة ملف محدد يحتوي على بيانات مكانية، سيتم تحليل الرأس لتحديد الأعمدة التي تحتوي على حقول الموقع. إذا كان الرأس يحتوي على معلومات الكتابة، استخدامه لإرسال قيم الخلايا إلى النوع المناسب. إذا لم يتم تحديد أي رأس، تحليل الصف الأول واستخدامه لإنشاء رأس. عند تحليل الصف الأول، يتم تنفيذ فحص لمطابقة أسماء الأعمدة مع الأسماء التالية بطريقة غير حساسة لحالة الأحرف. ترتيب الأسماء هو الأولوية، في حالة وجود اسمين أو أكثر في ملف.
خط العرض
latitudelatlatddlat_ddlatitude83latdecdegyycenterpoint-y
خط الطول
longitudelonlnglonglongddlong_ddlongitude83longdecdegxxcenterpoint-x
رفع
elevationelvaltitudealtz
الجغرافيا
سيتم فحص الصف الأول من البيانات بحثا عن سلاسل بتنسيق نص Well-Known.
أنواع أعمدة البيانات المحددة
عند مسح صف الرأس ضوئيا، سيتم استخراج أي معلومات نوع موجودة في اسم العمود واستخدامها لإرسال الخلايا في هذا العمود. فيما يلي مثال على اسم عمود له قيمة كتابة: "ColumnName (typeName)". يتم دعم أسماء الأنواع التالية غير الحساسة لحالة الأحرف:
الأرقام
- edm.int64
- int
- خط الطول
- edm.double
- حُر
- مزدوج
- العدد
القيم المنطقية
- edm.boolean
- Bool
- منطقي
التواريخ
- edm.datetime
- التاريخ
- التاريخ والوقت
الجغرافيا
- edm.geography
- جغرافيا
السلاسل
- edm.string
- varchar
- نص
- سلسلة
إذا لم يكن بالإمكان استخراج معلومات الكتابة من الرأس ، وتم تمكين خيار الكتابة الديناميكية عند القراءة ، تحليل كل خلية بشكل فردي لتحديد نوع البيانات الأنسب ليتم إرسالها على أنها كذلك.
الخطوات التالية
راجع المقالات التالية للحصول على مزيد من نماذج التعليمات البرمجية لإضافتها إلى خرائطك: