تشبه مربّعات "التجوّل الافتراضي"
المربّعات الثنائية الأبعاد
إلا أنها تحتوي على صور بانورامية تم التقاطها على مستوى الشارع. مع
"التجوّل الافتراضي"، يمكنك استكشاف معالم العالم، ومشاهدة عجائب الدنيا الطبيعية،
داخل أماكن مثل المتاحف أو الساحات أو المطاعم أو الشركات الصغيرة.
تتيح لك نقطة نهاية واجهة برمجة التطبيقات هذه الوصول إلى:
- مربّعات التجوّل الافتراضي في خرائط Google
- البيانات الوصفية لميزة "التجوّل الافتراضي"
- الصور المصغّرة لميزة "التجوّل الافتراضي"
يمكنك دمج مربّعات صور مأخوذة من مستوى الشارع معًا لإنشاء تأثير بانورامي واقعي. ويمكنك الاستعلام عن ما يصل إلى 100 معرف بانوراما لمجموعة واحدة للمواقع الجغرافية (مثل المسار) والحصول على بيانات وصفية أكثر تفصيلاً حول الكاميرا الموقع.
على المشاهد دمج مربّعات "التجوّل الافتراضي" معًا. على سبيل المثال، التجوّل الافتراضي عارض بانوراما مخصص.
بعد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك الوصول إلى صور "التجوّل الافتراضي" من خلال تنفيذ الخطوات التالية.
احصل على الرمز المميّز للجلسة. التأكد من لضبط قيمة
mapType
علىstreetview
.استخدِم الرمز المميّز للجلسة من أجل الحصول على معرِّف البانوراما (panoId) لموقع جغرافي واحد أو أكثر المواقع.
يمكنك استخدام معرّفات البانوراما من ردّ بحث panoId للحصول على ما يلي:
البيانات الوصفية لميزة "التجوّل الافتراضي" يمكنك أيضًا الحصول على رمز الشارع اعرض البيانات الوصفية بتمرير مجموعة من الإحداثيات ونصف قطرها.
طرق "التجوّل الافتراضي"
يمكنك الوصول إلى صور "التجوّل الافتراضي" والبيانات الوصفية من خلال إجراء أيّ مما يلي أربع طرق.
الطريقة | الوصف |
---|---|
https://tile.googleapis.com/v1/streetview/tiles |
تعرض مربّعات "التجوّل الافتراضي" الفردية. يمكنك استرداد مربّعات التجوّل الافتراضي بستة مستويات تكبير/تصغير: من 512 بكسل وحتى 13,312 بكسل. |
https://tile.googleapis.com/v1/streetview/panoIds |
تتيح لك البحث المجمّع عن ما يصل إلى 100 موقع. لعرض معرّفات البانوراما لجميع المواقع التي تحتوي على صور. |
https://tile.googleapis.com/v1/streetview/thumbnail |
لعرض صورة مصغّرة بتنسيق JPEG لمشهد التجوّل الافتراضي. تتيح لك هذه الميزة تقديم عنوان وعرض ترويجي وأبعاد ومجال رؤية. الحد الأدنى للأبعاد هو 16x16 بكسل. الحد الأقصى للأبعاد هو 250×600 بكسل. |
https://tile.googleapis.com/v1/streetview/metadata |
لتوفير معلومات تفصيلية حول الصورة البانورامية المحددة. وتتضمن التفاصيل العنوان ذي الصلة وروابط إلى صور بانورامية مجاورة. |
البحث عن أرقام تعريف panoId في "التجوّل الافتراضي"
يمكنك العثور على معرِّف البانوراما لموقع جغرافي واحد أو أكثر من خلال
تمرير إحداثياتهم (lat
، lng
) إلى طريقة panoIds
. الطلب
النص الأساسي هو كائن JSON يحتوي على مصفوفة locations
، ويمكنك
radius
، كما هو موضَّح في مثال رمز JSON التالي.
curl -X POST -d '{ "locations": [ {"lat": -33.883837, "lng": 151.209307}, {"lat": -33.883700, "lng": 151.210307}, {"lat": 0, "lng": 0} ], "radius": 50 }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY"
locations
- يجب أن يحتوي الصفيف
locations
على مجموعة واحدة على الأقل من قيم الإحداثيات، ولكن يمكنك تضمين المزيد، بحد أقصى 100 طلب. radius
- تحدّد قيمة
radius
(التي يتم قياسها بالمتر) نصف قطر الدائرة حول الموقع المحدد، والذي يمكن من خلاله البحث عن صور بانورامية. القيمة التلقائية هو 50 مترًا.
ردّ PanoId
تحاول واجهة برمجة تطبيقات مربعات الخرائط العثور على أقرب عرض بانوراما لكل موقع،
ثم تُرجع معرفات البانوراما الخاصة بها. يؤدي طلب panoIds
الناجح إلى إرجاع
كائن JSON يحتوي على مصفوفة panoIds
تحتوي الصفيفة على قائمة
معرفات بانوراما بالترتيب الذي طلبتها به. واجهة برمجة التطبيقات لشاشات المعلومات في حال
تعذر العثور على أي صور بانورامية للمواقع التي طلبتها، ثم
يتم عرض السلسلة في هذا الموقع في الصفيف. على سبيل المثال، راجع
باتباع رمز JSON.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
يمكنك استخدام panoIds
لإجراء ما يلي:
- طلب البيانات الوصفية لميزة "التجوّل الافتراضي"
- طلب صور مصغّرة لميزة "التجوّل الافتراضي"
- طلب مربّعات "التجوّل الافتراضي"
البيانات الوصفية لميزة "التجوّل الافتراضي"
طلبات البيانات الوصفية لميزة "التجوّل الافتراضي" تعرض معلومات عن الصور البانورامية. شارع طلب عرض البيانات الوصفية هو طلب HTTPS GET. يمكنك استرداد المعلومات حول الصور البانورامية بإحدى طريقتين:
في حال اجتياز
pano_id
، ستعرض Map Tiles API البيانات الوصفية لذلك بانوراما.في حال اجتياز
lat
وlng
، ستعرض Map Tiles API البيانات الوصفية. لأقرب بانوراما ضمن نصف قطر البحث المحدد.
تمرير مجموعة من الإحداثيات ونصف قطرها
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
نظرًا لأن معرّفات البانوراما مؤقتة، ننصحك بتمرير مجموعة من
الإحداثيات وقيمة radius
في طلب البيانات الوصفية الأوّلية لميزة "التجوّل الافتراضي".
للاطّلاع على مثال، اطّلِع على مقتطف الرمز التالي.
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
تمرير panoId لصورة في "التجوّل الافتراضي"
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
ردّ على البيانات الوصفية
رمز JSON التالي هو مثال على استجابة نموذجية للبيانات الوصفية.
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
"addressComponents": [
{
"longName": "United States",
"shortName": "United States",
"types": [
"country"
]
},
{
"longName": "Mountain View, California",
"shortName": "Mountain View, California",
"types": [
"locality"
]
},
{
"longName": "Charleston Rd",
"shortName": "Charleston Rd",
"types": [
"route"
]
},
{
"longName": "1635",
"shortName": "1635",
"types": [
"street_number"
]
}
],
"links": [
{
"panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
"heading": 274.47998046875,
"text": "Charleston Rd"
},
{
"panoId": "1cODYwFRw1aZ45IignDIMw",
"heading": 94.47999572753906,
"text": "Charleston Rd"
}
]
}
تحتوي القائمة التالية على تعريفات للحقول في نص الاستجابة.
panoId
- المعرّف الفريد لهذه البانوراما. لا ينبغي أن تعتمد على معرفات البانوراما صالحة لمدة أطول من جلسة مستخدم واحدة.
lat
،lng
- إحداثيات (خط العرض وخط الطول) للبانوراما. يمكن أن تكون هذه القيم مختلفة عن الإحداثيات التي مررت بها في الطلب لأن محاذاة الموقع الجغرافي إلى أقرب بانوراما
imageHeight
،imageWidth
- أبعاد الصورة البانورامية التي تم تركيبها
tileHeight
،tileWidth
- أبعاد مربّع بانوراما واحد
heading
- يتم قياس اتجاه البوصلة بالدرجات، في اتجاه عقارب الساعة من الشمال. العناوين هي ضمن النطاق [0,360]، ويمثّل الرقم 0 اتجاه الشمال.
tilt
- إمالة العرض البانورامي، يتم قياسها بالدرجات من القطب الجنوبي للجزء الجنوبي بانوراما إلى الأفق. تقع القيم المعروضة ضمن النطاق [0, 180]. قيمة 90 درجة تشير إلى أن الأفق تتم محاذاة بالفعل عند خط الاستواء البانوراما
roll
- الدوران حول خط الرؤية في اتجاه عقارب الساعة الذي تم تطبيقه على بانوراما لتسوية الأفق. تقع القيم المعروضة ضمن النطاق [0, 360].
imageryType
تشير السمة - إلى نوع الصورة. القيمتان الصالحتان هما
indoor
وoutdoor
. date
- تاريخ التقاط الصورة. لا تحتوي بعض الصور على بيانات تاريخ. ولكن عندما هذا الحقل متوفر، ويحتوي هذا الحقل على مجموعة من السنة (YYYY) والشهر (MM). على سبيل المثال: 2023-05 أو 2024.
copyright
- نص حقوق الطبع والنشر الذي يجب عرضه كإسناد مع رمز الشارع عرض الصورة
reportProblemLink
- رابط تشعّبي يمكن للمستخدمين استخدامه للإبلاغ عن المشاكل في محتوى "التجوّل الافتراضي" هذا مربع. يجب عرض هذا الرابط التشعبي في أسفل الجانب الأيسر من ويجب أن تتضمن نص رابط مفاده "الإبلاغ عن مشكلة" بهذه الصورة".
addressComponent
- عنصر أساسي الرمز الجغرافي يحتوي على تفاصيل حول عنوان البانوراما. لمزيد من المعلومات الرؤية طلبات وردود ترميز المواقع الجغرافية في مستندات Geocoding API
links
- قائمة بمعرّفات البانوراما التي ترتبط بهذه الصورة. يحتوي أيضًا على العنوان الذي تم العثور على الرابط فيه. على سبيل المثال، إذا كان العنوان 180 درجة، فإن البانوراما المرتبطة مطلوبة جنوب البانوراما الحالية. لاحظ أنه بسبب والطبيعة المؤقتة لمعرّفات البانوراما، فلا يجب الاعتماد عليها للحصول على من جلسة مستخدم واحدة.
الصور المصغّرة لميزة "التجوّل الافتراضي"
يمكنك طلب صور "التجوّل الافتراضي" بتنسيق thumbnail
. الصور المصغّرة هي
الصور غير المتجانبة ذات الحجم والعنوان ودرجة الصوت ومجال الرؤية الذي يحدده المستخدم.
تكون دقة الصور المصغّرة أقل من شاشات المربّعات، وهي أصغر حجمًا في الملف.
الحجم. يمكنك طلب صورة مصغّرة من خلال إرسال طلب GET إلى thumbnail
.
بنقطة النهاية، كما هو موضح في النموذج الأولي للتعليمة البرمجية التالي.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId &height=FROM_16_TO_250 &width=FROM_16_TO_600 &pitch=FROM-90_TO_90 &yaw=FROM-360_TO_360 &fov=FROM_30_TO_120"
بالنظر إلى مثال الرمز التالي، الذي يعمل على تنزيل صورة مصغّرة لميزة "التجوّل الافتراضي". الصور التي تم التقاطها في مدينة ويسلر في كندا.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=Zzl28rqGJgaL2IdkUleP8A &height=200 &width=200 &pitch=0 &yaw=250 &fov=80" --output /tmp/example_thumbnail.png
المعلمات المطلوبة
panoId
- المعرّف الفريد للصورة المصغّرة التي تريدها: يمكنك الحصول على قيم رقم تعريف البانوراما.
من نقطة نهاية
panoIds
أو من نقطة نهايةmetadata
، وكلاهما يقبل المواقع الجغرافية وترجع قيمةpanoId
المناسبة. session
- رمز مميز للجلسة صالح.
key
- مفتاح واجهة برمجة التطبيقات الخاص بك
المعلمات الاختيارية
height
- يحدد ارتفاع الصورة المصغّرة بالبكسل، بدءًا من 16 بكسل إلى 250 بكسل. إذا لم تحدد أي ارتفاع، سيتم ضبط الارتفاع تلقائيًا على هي 250 بكسل كحدّ أقصى للقيمة المسموح بها. إذا حددت قيمة خارج النطاق، عندها، يتم محاذاة الصورة المصغّرة مع أقرب قيمة صالحة.
width
- يحدد هذا الإعداد عرض الصورة المصغّرة بالبكسل، بدءًا من 16 بكسل إلى 600 بكسل. البكسل. في حال عدم تحديد عرض، يتم ضبط العرض تلقائيًا على الحدّ الأقصى. المسموح بها وهي 600 بكسل. إذا حددت قيمة خارج النطاق، فعندئذ محاذاة الصورة المصغّرة إلى أقرب قيمة صالحة
pitch
- يحدد هذا الإعداد زاوية الكاميرا على طول المحور العمودي. القيم الصالحة هي في
النطاق من
-90
إلى90
(ضمنًا). القيمة التلقائية هي 0. yaw
- يحدد اتجاه الكاميرا على طول المحور الأفقي. القيم الصالحة
تقع في النطاق من
-360
إلى360
(ضمنًا). القيمة التلقائية s 0. fov
- يحدد حقل العرض الأفقي، معبرًا عنه بالدرجات، مع حد أقصى. 120. عند التعامل مع إطار عرض ثابت الحجم، كما هو الحال مع "التجوّل الافتراضي" صورة ذات حجم محدد، ويمثل مجال الرؤية التكبير/التصغير؛ حيث تحدد القيم الأصغر مستوى أعلى من التكبير. القيمة التلقائية هي 90.
مربّعات صور "التجوّل الافتراضي"
بعد الحصول على panoId
، يمكنك طلب مربّع صورة "تجوّل افتراضي". البلاط
الطلبات هي طلبات HTTPS GET. ضع في الاعتبار المثال التالي.
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
في مثال الرمز هذا، z
هو مستوى التكبير/التصغير،
x
وy
هما
إحداثيات المربعات
من مربع التجوّل الافتراضي الذي تريده. يجب أن تكون مستويات التكبير/التصغير في الصور البانورامية في التجوّل الافتراضي
في النطاق [0,5]، حيث يمثل 0 أوسع مجال رؤية.
مستوى التكبير أو التصغير | مجال العرض التقريبي |
---|---|
0 | 360 درجة |
1 | 180 درجة |
2 | 90 درجة |
3 | 7 درجات |
4 | 22.5 درجة |
5 | 11.25 درجة |
ردود "التجوّل الافتراضي"
يؤدي طلب مربّع صورة "تجوّل افتراضي" ناجحًا إلى عرض صورة بالتنسيق والحجم
التي حدّدتها في ردّك على "createSession
".
عند مستوى التكبير/التصغير صفر، يتم تغيير حجم البانوراما بالكامل إلى مربع من الأبعاد
تم تحميل الفيديو "tileWidth
" من حساب "tileHeight
". ونظرًا لأن الصور البانورامية تكون أكبر في البعد س،
سيحتوي المربّع على مساحة فارغة في البُعد ص:
في المستوى الخامس من التكبير أو التصغير، يتم استخدام البانوراما بالحجم الكامل وتقسيمها إلى مربّعات.
معلومات حقوق الطبع والنشر
يجب عرض معلومات حقوق الطبع والنشر مع كل صورة بانورامية للتجوّل الافتراضي. تشير رسالة الأشكال البيانية
السلسلة المطلوب عرضها بين صور بانوراما. للحصول على معلومات حقوق الطبع والنشر،
يجب طلب البيانات الوصفية لميزة "التجوّل الافتراضي"، وبعد ذلك يمكنك
يُرجى الرجوع إلى حقل copyright
في الردّ. لمزيد من المعلومات، يُرجى مراجعة
تحديد مصدر البيانات: