تفاصيل تنسيق البيانات المدعومة

توفر هذه المقالة تفاصيل حول دعم القراءة والكتابة لكافة علامات تمييز 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، قد يكون هناك عمود يحتوي على بيانات الهندسة المكانية.

الكشف عن عمود البيانات المكانية

عند قراءة ملف محدد يحتوي على بيانات مكانية، سيتم تحليل الرأس لتحديد الأعمدة التي تحتوي على حقول الموقع. إذا كان الرأس يحتوي على معلومات الكتابة، استخدامه لإرسال قيم الخلايا إلى النوع المناسب. إذا لم يتم تحديد أي رأس، تحليل الصف الأول واستخدامه لإنشاء رأس. عند تحليل الصف الأول، يتم تنفيذ فحص لمطابقة أسماء الأعمدة مع الأسماء التالية بطريقة غير حساسة لحالة الأحرف. ترتيب الأسماء هو الأولوية، في حالة وجود اسمين أو أكثر في ملف.

خط العرض

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

خط الطول

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

رفع

  • elevation
  • elv
  • altitude
  • alt
  • z

الجغرافيا

سيتم فحص الصف الأول من البيانات بحثا عن سلاسل بتنسيق نص Well-Known.

أنواع أعمدة البيانات المحددة

عند مسح صف الرأس ضوئيا، سيتم استخراج أي معلومات نوع موجودة في اسم العمود واستخدامها لإرسال الخلايا في هذا العمود. فيما يلي مثال على اسم عمود له قيمة كتابة: "ColumnName (typeName)". يتم دعم أسماء الأنواع التالية غير الحساسة لحالة الأحرف:

الأرقام

  • edm.int64
  • int
  • خط الطول
  • edm.double
  • حُر
  • مزدوج
  • العدد

القيم المنطقية

  • edm.boolean
  • Bool
  • منطقي

التواريخ

  • edm.datetime
  • التاريخ
  • التاريخ والوقت

الجغرافيا

  • edm.geography
  • جغرافيا

السلاسل

  • edm.string
  • varchar
  • نص
  • سلسلة

إذا لم يكن بالإمكان استخراج معلومات الكتابة من الرأس ، وتم تمكين خيار الكتابة الديناميكية عند القراءة ، تحليل كل خلية بشكل فردي لتحديد نوع البيانات الأنسب ليتم إرسالها على أنها كذلك.

الخطوات التالية

راجع المقالات التالية للحصول على مزيد من نماذج التعليمات البرمجية لإضافتها إلى خرائطك:

قراءة وكتابة البيانات المكانية