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

تتيح هذه المقالة تفاصيل حول دعم القراءة والكتابة لكافة علامات XML وأنواع هندسة النص المعروفة جيدًا. كما توضح بالتفصيل كيفية تحليل البيانات المكانية المحددة في وحدة الإدخال والإخراج المكانية النمطية.

مساحات أسماء XML مدعومة

تدعم وحدة الإدخال والإخراج المكانية علامات XML من مساحات الأسماء التالية.

بادئة خاصة بمساحة الاسم	معرف موارد منتظم مساحة الاسم	ملاحظات
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 مدعومة

تدعم وحدة الإدخال والإخراج النمطية المكانية عناصر XML التالية. يتم تحويل أي علامات XML غير معتمدة إلى كائن JSON. بعد ذلك، تتم إضافة كل علامة كخاصية في properties حقل الشكل أو الطبقة الأصل.

العناصر الخاصة بـ KML

تدعم وحدة الإدخال والإخراج النمطية المكانية عناصر XML الموضحة أدناه.

اسم العنصر	قراءة	الكتابة	ملاحظات
address	جزئية	yes	يحلل العنصر ولكن لا يستخدم لوضع الشكل.
AddressDetails	جزئية	no	يحلل العنصر ولكن لا يستخدم لوضع الشكل.
atom:author	yes	yes
atom:link	yes	yes
atom:name	yes	yes
BalloonStyle	جزئية	جزئية	displayMode غير مدعوم. محول إلي PopupTemplate. للكتابة، أضف خاصية popupTemplate كخاصية للميزة التي تريد الكتابة لها.
begin	yes	yes
color	yes	yes	ويتضمن #AABBGGRR و#BBGGRR. موزع في سلسلة ألوان CSS
colorMode	yes	no
coordinates	yes	yes
Data	yes	yes
description	yes	yes
displayName	yes	yes
Document	yes	yes
drawOrder	جزئية	no	اقرأ عن تراكبات الأرض واستخدامها لفرزها.
east	yes	yes
end	yes	yes
ExtendedData	yes	yes	يدعم الاستبدالات غير المصنفةData، SimpleData أو Schema استبدال العنصر للنموذج $[dataName].
extrude	جزئية	جزئية	مدعوم فقط للمضلعات. يتم تقسيم MultiGeometry التي تحتوي على مضلعات ذات ارتفاعات مختلفة إلى ميزات فردية. أنماط الخطوط غير مدعومة. يتم عرض المضلعات التي يبلغ ارتفاعها 0 كمضلع مسطح. عند القراءة، تتم إضافة ارتفاع الإحداثيات الأولى في الحلقة الخارجية كخاصية ارتفاع المضلع. ثم، يتم استخدام ارتفاع الإحداثيات الأولى لعرض المضلع على الخريطة.
fill	yes	yes
Folder	yes	yes
GroundOverlay	yes	yes	color غير مدعوم
heading	جزئية	no	حلل ولكن لم يعرض من قبلSimpleDataLayer. يكتب إذا خزنت البيانات في خاصية الشكل فقط.
hotSpot	yes	جزئية	يكتب إذا خزنت البيانات في خاصية الشكل فقط. تخرج الوحدات على هيئة «بكسل» فقط.
href	yes	yes
Icon	جزئية	جزئية	حلل ولكن لم يعرض من قبلSimpleDataLayer. يكتب فقط خاصية رمز الشكل إذا كان يحتوي على بيانات URI. يتم دعم href فقط.
IconStyle	جزئية	جزئية	iconheadingcolorModeيتم تحليل القيم وhotspots، ولكن لا يتم عرضها بواسطةSimpleDataLayer
innerBoundaryIs	yes	yes
kml	yes	yes
LabelStyle	no	no
LatLonBox	yes	yes
gx:LatLonQuad	yes	yes
LinearRing	yes	yes
LineString	yes	yes
LineStyle	yes	yes	colorMode غير مدعوم.
Link	yes	no	تدعم الخاصية href لارتباطات الشبكة فقط.
MultiGeometry	جزئية	جزئية	يمكن تقسيمها إلى ميزات فردية عند قراءتها.
name	yes	yes
NetworkLink	yes	no	يجب أن تكون الروابط على نفس المجال مثل المستند.
NetworkLinkControl	no	no
north	yes	yes
open	yes	yes
outerBoundaryIs	yes	yes
outline	yes	yes
overlayXY	no	no
Pair	جزئية	no	يدعم normalالنمط الموجود في StyleMap فقط. highlight غير مدعوم.
phoneNumber	yes	yes
PhotoOverlay	no	no
Placemark	yes	yes
Point	yes	yes
Polygon	yes	yes
PolyStyle	yes	yes
Region	جزئية	جزئية	LatLongBoxمدعوم على مستوى المستند.
rotation	no	no
rotationXY	no	no
scale	no	no
Schema	yes	yes
SchemaData	yes	yes
schemaUrl	جزئية	yes	لا يدعم تحميل الأنماط من مستندات خارجية غير مرفقة في KMZ.
ScreenOverlay	no	no
screenXY	no	no
SimpleData	yes	yes
SimpleField	yes	yes
size	no	no
Snippet	جزئية	جزئية	maxLines تهمل السمة.
south	yes	yes
Style	yes	yes
StyleMap	جزئية	no	يدعم النمط العادي فقط في StyleMap.
styleUrl	جزئية	yes	عناوين URL ذات النمط الخارجي غير مدعومة.
text	yes	yes	استبدال $[geDirections] غير مدعوم
textColor	yes	yes
TimeSpan	yes	yes
TimeStamp	yes	yes
value	yes	yes
viewRefreshMode	جزئية	no	في حالة الإشارة إلى خدمة WMS، فستدعم التراكبات الأرضية فقط onStop. إلحاق BBOX={bboxWest},{bboxSouth},{bboxEast},{bboxNorth} بعنوان URL والتحديث مع انتقال الخريطة.
visibility	yes	yes
west	yes	yes
when	yes	yes
width	yes	yes

العناصر الخاصة بـ GeoRSS

تدعم وحدة الإدخال والإخراج النمطية المكانية عناصر GeoRSS التالية.

اسم العنصر	قراءة	الكتابة	ملاحظات
atom:author	yes	yes
atom:category	yes	yes
atom:content	yes	yes
atom:contributor	yes	yes
atom:email	yes	yes
atom:entry	yes	yes
atom:feed	yes	yes
atom:icon	yes	yes
atom:id	yes	yes
atom:link	yes	yes
atom:logo	yes	yes
atom:name	yes	yes
atom:published	yes	yes
atom:rights	yes	yes
atom:source	yes	yes
atom:subtitle	yes	yes
atom:summary	yes	yes
atom:title	yes	yes
atom:updated	yes	yes
atom:uri	yes	yes
geo:lat	yes	no	مكتوب علي هيئةgeorss:point.
geo:lon	yes	no	مكتوب علي هيئةgeorss:point.
geo:long	yes	no	مكتوب علي هيئةgeorss:point.
georss:box	yes	no	قراءة كمضلع وإعطائهاsubType خاصية «المستطيل»
georss:circle	yes	yes
georss:elev	yes	yes
georss:featurename	yes	yes
georss:featuretypetag	yes	yes
georss:floor	yes	yes
georss:line	yes	yes
georss:point	yes	yes
georss:polygon	yes	yes
georss:radius	yes	yes
georss:relationshiptag	yes	yes
georss:where	yes	yes
geourl:latitude	yes	no	مكتوب علي هيئةgeorss:point.
geourl:longitude	yes	no	مكتوب علي هيئةgeorss:point.
position	yes	no	تقوم بعض موجزات XML بتغليف GML بعلامة موضع بدلا من تضمينها بعلامة georss:where . اقرأ هذه العلامة، ولكن تكتب باستخدام علامة georss:where .
rss	yes	no	يعد GeoRSS مكتوب بتنسيق ATOM.
rss:author	yes	جزئية	مكتوب علي هيئةatom:author.
rss:category	yes	جزئية	مكتوب علي هيئةatom:category.
rss:channel	yes	no
rss:cloud	yes	no
rss:comments	yes	no
rss:copyright	yes	جزئية	مكتوبة atom:rights كشكل إذا لم يكن للشكل rights properties خاصية بالفعل.
rss:description	yes	جزئية	مكتوبة atom:content كشكل إذا لم يكن للشكل content properties خاصية بالفعل.
rss:docs	yes	no
rss:enclosure	yes	no
rss:generator	yes	no
rss:guid	yes	جزئية	مكتوبة atom:id كشكل إذا لم يكن للشكل id properties خاصية بالفعل.
rss:image	yes	جزئية	مكتوبة atom:logo كشكل إذا لم يكن للشكل logo properties خاصية بالفعل.
rss:item	yes	جزئية	مكتوب علي هيئةatom:entry.
rss:language	yes	no
rss:lastBuildDate	yes	جزئية	مكتوبة atom:updated كشكل إذا لم يكن للشكل updated properties خاصية بالفعل.
rss:link	yes	جزئية	مكتوب علي هيئةatom:link.
rss:managingEditor	yes	جزئية	مكتوب علي هيئةatom:contributor.
rss:pubDate	yes	جزئية	مكتوبة atom:published كشكل إذا لم يكن للشكل published properties خاصية بالفعل.
rss:rating	yes	no
rss:skipDays	yes	no
rss:skipHours	yes	no
rss:source	yes	جزئية	مكتوبة علي هيئة atom:source على أنها تحتوي على atom:link.
rss:textInput	yes	no
rss:title	yes	جزئية	مكتوب علي هيئةatom:title.
rss:ttl	yes	no
rss:webMaster	yes	no

العناصر الخاصة بـ GML

تدعم وحدة الإدخال والإخراج النمطية المكانية عناصر GML التالية.

اسم العنصر	قراءة	الكتابة	ملاحظات
gml:coordinates	yes	no	مكتوب علي هيئةgml:posList.
gml:curveMember	yes	no
gml:curveMembers	yes	no
gml:Box	yes	no	مكتوب علي هيئةgml:Envelope.
gml:description	yes	yes
gml:Envelope	yes	yes
gml:exterior	yes	yes
gml:Feature	yes	no	مكتوب علي هيئة شكل.
gml:FeatureCollection	yes	no	مكتوب علي هيئة مجموعة هندسية.
gml:featureMember	yes	no	مكتوب علي هيئة مجموعة هندسية.
gml:geometry	yes	no	مكتوب علي هيئة شكل.
gml:geometryMember	yes	yes
gml:geometryMembers	yes	yes
gml:identifier	yes	yes
gml:innerBoundaryIs	yes	no	مكتوب عن طريق استخدام gml.interior.
gml:interior	yes	yes
gml:LinearRing	yes	yes
gml:LineString	yes	yes
gml:lineStringMember	yes	yes
gml:lineStringMembers	yes	no
gml:MultiCurve	yes	no	يتيح gml:LineString القراءة للأعضاء فقط. مكتوب علي هيئةgml.MultiLineString
gml:MultiGeometry	جزئية	جزئية	للقراءة فقط علي هيئة FeatureCollection.
gml:MultiLineString	yes	yes
gml:MultiPoint	yes	yes
gml:MultiPolygon	yes	yes
gml:MultiSurface	yes	no	يتيح gml:Polygon القراءة للأعضاء فقط. مكتوب علي هيئةgml.MultiPolygon
gml:name	yes	yes
gml:outerBoundaryIs	yes	no	مكتوب عن طريق استخدام gml.exterior.
gml:Point	yes	yes
gml:pointMember	yes	yes
gml:pointMembers	yes	no
gml:Polygon	yes	yes
gml:polygonMember	yes	yes
gml:polygonMembers	yes	no
gml:pos	yes	yes
gml:posList	yes	yes
gml:surfaceMember	yes	yes

المزيد من الملاحظات

• يتم البحث عن عناصر الأعضاء عن هندسة يمكن دفنها داخل العناصر التابعة. تعد عملية البحث هذه ضرورية لأن العديد من تنسيقات XML التي تمتد من GML يمكن ألا تضع الهندسة كعنصر ثانوي مباشر لعنصر عضو.
• srsName مدعوم جزئيا لإحداثيات WGS84 والرموز الموضحة أدناه: EPSG:4326)، و Web Mercator (EPSG:3857 أو أحد رموزه البديلة. يتم تحليل أي نظام إحداثيات آخر على أنه WGS84 كما هو.
• ما لم يتم تحديده عند قراءة موجز XML، يحدد ترتيب المحور بناءً على تلميحات في موجز XML. تعطي الأفضلية لترتيب المحور «خطوط الطول والعرض».
• ما لم يتم تحديد مساحة اسم GML مخصصة للخصائص عند الكتابة إلى ملف GML، لا تتم إضافة معلومات خاصية أخرى.

عناصر خاصة بـ GPX

تدعم وحدة الإدخال والإخراج النمطية المكانية عناصر GPX الموضحة أدناه.

اسم العنصر	قراءة	الكتابة	ملاحظات
gpx:ageofdgpsdata	yes	yes
gpx:author	yes	yes
gpx:bounds	yes	yes	يحول إلى LocationRect عند القراءة.
gpx:cmt	yes	yes
gpx:copyright	yes	yes
gpx:desc	yes	yes	ينسخ في خاصية الوصف عند قراءته ليتماشى مع تنسيقات XML الأخرى.
gpx:dgpsid	yes	yes
gpx:ele	yes	yes
gpx:extensions	جزئية	جزئية	عند القراءة، تستخرج معلومات النمط. يتم تبسيط جميع الملحقات الأخرى في كائن JSON بسيط. تكتب معلومات نمط الشكل فقط.
gpx:geoidheight	yes	yes
gpx:gpx	yes	yes
gpx:hdop	yes	yes
gpx:link	yes	yes
gpx:magvar	yes	yes
gpx:metadata	yes	yes
gpx:name	yes	yes
gpx:pdop	yes	yes
gpx:rte	yes	yes
gpx:rtept	yes	yes
gpx:sat	yes	yes
gpx:src	yes	yes
gpx:sym	yes	yes	تسجل القيمة، لكن لا تستخدم لتغيير رمز دبوس التثبيت.
gpx:text	yes	yes
gpx:time	yes	yes
gpx:trk	yes	yes
gpx:trkpt	yes	yes
gpx:trkseg	yes	yes
gpx:type	yes	yes
gpx:vdop	yes	yes
gpx:wpt	yes	yes
gpx_style:color	yes	yes
gpx_style:line	جزئية	جزئية	color، opacity، width، lineCapمدعومين.
gpx_style:opacity	yes	yes
gpx_style:width	yes	yes
gpxx:DisplayColor	yes	no	يستخدم لتحديد اللون الخاص بالشكل. في حالة الكتابة، gpx_style:line يتم استخدام اللون بدلا من ذلك.
gpxx:RouteExtension	جزئية	no	تقرأ كافة الخصائص في properties. يستخدم DisplayColorفقط.
gpxx:TrackExtension	جزئية	no	تقرأ كافة الخصائص في properties. يستخدم DisplayColorفقط.
gpxx:WaypointExtension	جزئية	no	تقرأ كافة الخصائص في properties. يستخدم DisplayColorفقط.
gpx:keywords	yes	yes
gpx:fix	yes	yes

المزيد من الملاحظات

أثناء الكتابة؛

• يتم تقسيم MultiPoints إلى نقاط طريق فردية.
• تتم كتابة المضلعات والمضلعات المتعددة كمسارات.

أنواع هندسة النص المدعوم والمعروفة جيدًا

نوع الهندسة	قراءة	الكتابة
نقطة	×	×
POINT Z	×	×
POINT M	×	x[2]
POINT ZM	x[1][2]
LINESTRING	×	×
LINESTRING Z	×	×
LINESTRING M	×	x[2]
LINESTRING ZM	x[1][2]
POLYGON	×	×
POLYGON Z	×	×
POLYGON M	×	x[2]
POLYGON ZM	x[1][2]
MULTIPOINT	×	×
MULTIPOINT Z	×	×
MULTIPOINT M	×	x[2]
POMULTIPOINTINT ZM	x[1][2]
MULTILINESTRING	×	×
MULTILINESTRING Z	×	×
MULTILINESTRING M	×	x[2]
MULTILINESTRING ZM	x[1][2]
MULTIPOLYGON	×	×
MULTIPOLYGON Z	×	×
MULTIPOLYGON M	×	x[2]
MULTIPOLYGON ZM	x[1][2]
GEOMETRYCOLLECTION	×	×
GEOMETRYCOLLECTION Z	×	×
GEOMETRYCOLLECTION M	×	x[2]
GEOMETRYCOLLECTION ZM	x[1][2]	×

[1] تلتقط معلمة Z فقط وتضاف كقيمة ثالثة في قيمة الموضع.

[2] لا تلتقط معلمة M.

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

غالبًا ما تحتوي البيانات المكانية المحددة، مثل ملفات القيم المفصولة بفواصل (CSV)، على أعمدة تحتوي على بيانات مكانية. على سبيل المثال، يمكن أن تكون هناك أعمدة تحتوي على معلومات خط الطول والعرض. في تنسيق Well-Known Text، يمكن أن يكون هناك عمود يحتوي على بيانات الهندسة المكانية.

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

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

خط العرض

• 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

• elevation
• elv
• altitude
• alt
• z

الموقع الجغرافي

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

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

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

أرقام

• edm.int64
• العدد الصحيح
• طويل
• edm.double
• عائم
• مزدوج
• رقم

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

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

التواريخ

• edm.datetime
• date
• datetime

الموقع الجغرافي

• edm.geography
• المنطقة الجغرافية

السلاسل

• edm.string
• حروف متنوعة
• النص
• سلسلة

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

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

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

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