الرمز المميز للجلسة هو جزء من البيانات (
UUID).
يُستخدم في استدعاءات REST لتحديد
الجلسة: a
سلسلة من تبادلات الرسائل ذات الصلة. يجب تضمين رمز مميز للجلسة في جميع
طلبات للحصول على مربّعات ثنائية الأبعاد وصور "التجوّل الافتراضي"
يتم إدراجه كقيمة معلَمة session
ملحقة بكل الطلبات
عناوين URL.
في Map Tiles API، يمثل الرمز المميز للجلسة مجموعة محددة من
خيارات العرض. يعني ذلك أنك لست مضطرًا لتمرير مجموعة من خيارات العرض مع
كل طلب تجانب. يمكنك استخدام نفس الرمز المميز للجلسة عبر عدة برامج.
يكون الرمز المميز للجلسة صالحًا حاليًا لمدة أسبوعين من
وقت المشكلة، ولكن هذا قد يتغير. يمكنك دائمًا التحقق من وقت انتهاء صلاحية
للجلسة من خلال الاطّلاع على الحقل expiry
في رسالة الرد.
طلب الرمز المميّز للجلسة
لطلب رمز مميّز للجلسة، أرسِل طلب HTTPS POST إلى "createSession
".
نقطة نهاية، كما هو موضح في المثال التالي. يجب إرسال الطلب مع
عنوان Content-Type: application/json
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
حقول مطلوبة
mapType
نوع الخريطة الأساسية. ويمكن أن تكون هذه القيمة واحدة مما يلي:
roadmap
- مربعات الخرائط العادية المرسومة في "خرائط Google"
satellite
- صور القمر الصناعي:
terrain
- صور التضاريس عند اختيار
terrain
كنوع الخريطة، يجب عليك أيضًا أدرِج نوع الطبقةlayerRoadmap
(الموضّح في الحقول الاختيارية ). streetview
- صور بانورامية في "التجوّل الافتراضي". لمزيد من المعلومات، يُرجى مراجعة بلاط "التجوّل الافتراضي":
language
إنّ علامة لغة مجموعة مهندسي شبكة الإنترنت (IETF) تحدد اللغة المستخدمة لعرض المعلومات على المربعات. بالنسبة على سبيل المثال، يحدد
en-US
اللغة الإنجليزية كما يتم التحدث بها في الولايات المتحدة.region
حاسمة مستودع بيانات اللغة الشائعة معرّف المنطقة (حرفان كبيران) يمثّلان الموقع الجغرافي للمستخدم. مثلاً:
US
حقول اختيارية
imageFormat
- تحديد تنسيق الملف المطلوب عرضه القيمتان الصالحتان هما
jpeg
أوpng
. لا توفّر ملفات JPEG الشفافية، لذلك لا يُنصح باستخدامها. تراكب المربّعات. إذا لم تحددimageFormat
، في هذه الحالة أفضل تنسيق يتم اختيار المربّع تلقائيًا. scale
لتكبير حجم عناصر الخريطة (مثل ملصقات الطرق)، مع الاحتفاظ حجم المربّع ومنطقة التغطية للمربّع التلقائي تؤدي زيادة المقياس أيضًا يقلل من عدد التسميات على الخريطة، مما يقلل من الفوضى. ما يلي: تكون القيم هي قيم
scale
صالحة:scaleFactor1x
: القيمة التلقائية.scaleFactor2x
: لمضاعفة حجم التصنيف وإزالة تصنيفات الميزات الثانوية.scaleFactor4x
: يزيد حجم التصنيف أربع مرات ويزيل تصنيفات الميزات الثانوية.
توضح الأمثلة التالية تأثير تحجيم عناصر الخريطة.
عامل المقياس 1x | عامل المقياس 2x |
---|---|
highDpi
- يحدد هذا الإعداد ما إذا كان سيتم عرض المربّعات عالية الدقة. إذا كان عامل المقياس هو
زيادة، يتم استخدام
highDpi
لزيادة حجم المربّع. في العادة، تؤدي زيادة عامل المقياس إلى تكبير المربع الناتج إلى صورة نفس الحجم، مما يقلل من الجودة. باستخدامhighDpi
، يكون الحجم الناتج أيضًا وزيادة الجودة، مع الحفاظ على الجودة. يعني الاختصار DPI النقاط لكل بوصة، ويعني ارتفاع DPI يتم عرض المربع باستخدام المزيد من النقاط لكل بوصة أكثر من المعتاد. إذا كانتtrue
، تكون عدد وحدات البكسل في كل من الأبعاد (س) و(ص) تم ضربه في المقياس العامل (أي 2x أو 4x). تظل منطقة تغطية المربّع بدون تغيير. لا تعمل هذه المعلمة إلا مع قيمscale
التي تكون 2x أو 4x. ليس له أي تأثير في مربّعات مقياس 1x
عامل المقياس 1x | عامل المقياس 2x عدد النقاط لكل بوصة (DPI) عالية |
---|---|
layerTypes
مصفوفة من القيم تحدد أنواع الطبقات التي تمت إضافتها إلى الخريطة. صالحة القيم هي:
layerRoadmap
- مطلوب عند تحديد
terrain
كنوع الخريطة. يمكنك أيضًا اختيار إضافة عناصر. على نوع الخريطةsatellite
. ليس له أي تأثير في مربّعات خارطة الطريق. layerStreetview
- عرض الشوارع والمواقع الجغرافية التي تم تفعيل ميزة "التجوّل الافتراضي" فيها باستخدام مخططات زرقاء على الخريطة.
layerTraffic
- عرض أحوال حركة المرور الحالية
styles
يشير هذا المصطلح إلى مصفوفة من كائنات نمط JSON تحدّد مظهر ومستوى تفاصيل ميزات الخريطة مثل الطرق والمنتزهات والمناطق المبنية. يُستخدم التصميم تخصيص خريطة Google الأساسية القياسية. تكون المعلمة
styles
صالحة فقط إذا يكون نوع الخريطة هوroadmap
. للاطلاع على بناء جملة النمط بالكامل، راجع مرجع النمط:overlay
قيمة منطقية تحدد ما إذا كان يجب تنفيذ
layerTypes
المعروض كتراكب منفصل، أو دمجها مع الصور الأساسية. فعندماtrue
، لم يتم عرض الخريطة الأساسية. إذا لم تكن قد حدّدت أيًا من النوعlayerTypes
، فمن ثم يتم تجاهل هذه القيمة.
على سبيل المثال، طلب نوع الخريطة satellite
مع طبقة layerRoadmap
تم ضبط overlay
على false
من النتائج في مربّعات مكافئة لنوع الخريطة "hybrid
".
مستخدمة في واجهة برمجة تطبيقات JavaScript للخرائط (الصورة على اليمين). نفسه
أنواع الخريطة والطبقات عند ضبط overlay
على true
يؤدي إلى ظهور مربّع شفاف
مع تراكب خريطة، مصمم بشكل مناسب لتراكب صور القمر الصناعي
(الصورة على اليسار).
overlay : خطأ |
overlay : صحيح |
---|---|
مثال JSON التالي هو مثال لنص طلب نموذجي يحتوي على كليهما الحقول المطلوبة والاختيارية.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
يقدم هذا المثال تراكبًا مناسبًا للدمج مع القمر الصناعي الصور. يحتوي المثال على خارطة طريق وتراكب صور "تجوّل افتراضي". تشير رسالة الأشكال البيانية يتم عرض الخريطة بأسماء وبيانات باللغة الإنجليزية، حيث إنها كما يتحدث في الولايات المتحدة.
apiOptions
: مصفوفة من القيم تحدد خيارات إضافية لتطبيقها.
الخيارات المتاحة هي:
MCYJ5E517XR2JC
- فعّل الميزة خريطة جديدة التصميم. خلال فترة الموافقة، ستحصل طلباتك على البيانات الحالية. ما لم يتم تحديد هذه القيمة.
ردّ الرمز المميّز للجلسة
مثال على نص الاستجابة هو JSON التالي.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
تحتوي القائمة التالية على تعريفات للحقول في نص الاستجابة.
session
- قيمة للرمز المميز للجلسة يجب تضمينها في جميع واجهات برمجة تطبيقات Map Tiles API الطلبات
expiry
- سلسلة تحتوي على الوقت (بالثواني منذ الحقبة) الذي تم فيه استخدام الرمز المميز تنتهي صلاحيته. الرمز المميز للجلسة صالح لمدة أسبوعين من إنشائه ولكن قد تتغير هذه السياسة بدون إشعار.
tileWidth
- عرض المربّعات بالبكسل.
tileHeight
- يتم قياس ارتفاع المربّعات بالبكسل.
imageFormat
- تنسيق الصورة، والذي يمكن أن يكون
png
أوjpeg
.