مقدمة
باستخدام عناوين URL على "خرائط Google"، يمكنك إنشاء عنوان URL عام متعدد المنصات لتشغيل خرائط Google وإجراء عمليات البحث والحصول على الاتجاهات والتنقّل وعرض طرق عرض الخريطة والصور البانورامية. وتكون بنية عنوان URL مماثلة بغض النظر عن النظام الأساسي المستخدَم.
لست بحاجة إلى مفتاح Google API لاستخدام عناوين URL للخرائط.
البنية العامة على عدّة منصات
بصفتك مطوّرًا لأحد تطبيقات Android أو تطبيقات iOS أو مواقع إلكترونية، يمكنك إنشاء عنوان URL مشترك، وسيفتح تطبيق "خرائط Google" وينفّذ الإجراء المطلوب، بصرف النظر عن النظام الأساسي المستخدَم عند فتح الخريطة.
- على جهاز Android:
- في حال تثبيت تطبيق "خرائط Google" لنظام التشغيل Android وتفعيله، يبدأ عنوان URL تشغيل "خرائط Google" في تطبيق "خرائط Google" وينفّذ الإجراء المطلوب.
- في حال عدم تثبيت تطبيق "خرائط Google" أو إيقافه، سيتم تشغيل عنوان URL لخدمة "خرائط Google" في المتصفح وتنفيذ الإجراء المطلوب.
- على جهاز iOS:
- في حال تثبيت تطبيق "خرائط Google" لنظام التشغيل iOS، سيتم تشغيل عنوان URL على "خرائط Google" في تطبيق "خرائط Google" وتنفيذ الإجراء المطلوب.
- في حال عدم تثبيت تطبيق "خرائط Google"، يبدأ عنوان URL في تشغيل "خرائط Google" على المتصفّح وينفّذ الإجراء المطلوب.
- على أي جهاز آخر، يُطلق عنوان URL "خرائط Google" في المتصفح وينفّذ الإجراء المطلوب.
ننصحك باستخدام عنوان URL من عدّة منصات لتشغيل "خرائط Google" من تطبيقك أو موقعك الإلكتروني، لأنّ عناوين URL العامة هذه تتيح معالجة طلبات الخرائط على نطاق أوسع بغض النظر عن النظام الأساسي المستخدَم. بالنسبة إلى الميزات التي قد تعمل فقط على منصّة جوّال (على سبيل المثال، التنقّل باتّجاهات مفصّلة)، قد تفضّل استخدام خيار خاص بالنظام الأساسي لنظام التشغيل Android أو iOS. اطّلِع على المستندات التالية:
- خدمة "خرائط Google" المتوفرة لنظام التشغيل Android، خاصةً لإطلاق تطبيق "خرائط Google" لنظام التشغيل Android
- مخطط عناوين URL لتطبيق "خرائط Google" لنظام التشغيل iOS، لا سيما لإطلاق تطبيق "خرائط Google" لنظام التشغيل iOS
إطلاق "خرائط Google" وتنفيذ إجراء معيّن
لتشغيل "خرائط Google" وتنفيذ إحدى الدوال المتاحة بشكل اختياري، استخدِم مخطط عنوان URL لأحد النماذج التالية، استنادًا إلى الإجراء المطلوب:
- بحث Google
— يمكنك إطلاق خريطة Google تعرض دبوسًا لمكان معيّن، أو إجراء
بحث عام وإطلاق خريطة لعرض النتائج:
https://www.google.com/maps/search/?api=1¶meters
- الاتجاهات
يمكنك طلب الاتجاهات وتشغيل "خرائط Google" باستخدام النتائج:
https://www.google.com/maps/dir/?api=1¶meters
- عرض خريطة
— يمكنك تشغيل "خرائط Google" بدون علامات أو اتجاهات:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- عرض بانوراما في "التجوّل الافتراضي"
— إطلاق صورة تفاعلية بانورامية:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
ملاحظة مهمة: تُحدِّد المعلّمة api=1
إصدار
عناوين URL التي تتضمّن عناوين URL على "خرائط Google". وتكون هذه المعلّمة مطلوبة في كل طلب. القيمة الصالحة الوحيدة هي 1. إذا لم يتوفّر api=1
في عنوان URL،
سيتم تجاهل كل المعلّمات وسيتم تشغيل تطبيق "خرائط Google" التلقائي، إما
في متصفّح أو تطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة، حسب النظام الأساسي المستخدَم
(مثل https://www.google.com/maps).
إنشاء عناوين URL صالحة
يجب ترميز عناوين URL بشكل صحيح.
على سبيل المثال، تستخدِم بعض المعلّمات رمز الشرطة الرأسية (|
) كفاصل، ويجب عليك ترميزه باستخدام الرمز %7C
في رابط عنوان URL النهائي. تستخدم معلمات أخرى قيمًا مفصولة بفواصل، مثل إحداثيات خطوط الطول/العرض أو المدينة أو الولاية. يجب ترميز الفاصلة باعتبارها %2C
. يجب ترميز مساحات العمل باستخدام
%20
أو استبدالها بعلامة الجمع (+
).
بالإضافة إلى ذلك، تقتصر عناوين URL على 2048 حرفًا لكل طلب. ويجب مراعاة هذا الحد عند إنشاء عناوين URL.
الإجراءات على الخريطة
الإجراءات على الخريطة المتاحة هي: البحث والاتجاهات وعرض الخريطة وعرض
صورة بانورامية للتجوّل الافتراضي. ويمكنك تحديد الإجراء في عنوان URL للطلب، بالإضافة إلى المعلّمات المطلوبة والاختيارية. وكما هو الحال في عناوين URL، يمكنك الفصل بين المعلّمات باستخدام حرف العطف (&
). بالنسبة إلى كل إجراء، يتم سرد قائمة المعلّمات وقيمها المحتملة في قسم معلَمات البحث.
بحث
يعرض إجراء البحث نتائج البحث عن منطقة الخريطة المرئية. عند البحث عن مكان محدّد، تضع الخريطة الناتجة دبوسًا في الموقع الجغرافي المحدّد وتعرض تفاصيل المكان المتوفّرة.
تشكيل عنوان URL للبحث
https://www.google.com/maps/search/?api=1¶meters
المَعلمات
query
(مطلوبة): لتحديد الأماكن التي يجب تمييزها على الخريطة. معلَمة طلب البحث مطلوبة لكل طلبات البحث.- حدّد المواقع الجغرافية إما كاسم مكان أو عنوان أو إحداثيات خط الطول/خط العرض
مفصولة بفواصل. يجب أن تكون السلاسل
مشفّرة باستخدام عنوان URL، أي أنّه يجب تحويل العنوان
مثل "City; City Hall, New York, NY" إلى
City+Hall%2C+New+York%2C+NY
. - حدِّد عبارات البحث العامة
كسلسلة مُشفّرة لعنوان URL، مثل
grocery+stores
أوrestaurants+in+seattle+wa
.
- حدّد المواقع الجغرافية إما كاسم مكان أو عنوان أو إحداثيات خط الطول/خط العرض
مفصولة بفواصل. يجب أن تكون السلاسل
مشفّرة باستخدام عنوان URL، أي أنّه يجب تحويل العنوان
مثل "City; City Hall, New York, NY" إلى
query_place_id
(اختياري): رقم تعريف مكان هو معرّف نصي يحدّد مكانًا بشكل فريد. بالنسبة إلى الإجراءsearch
، عليك تحديدquery
، ولكن يمكنك أيضًا تحديدquery_place_id
. إذا حدّدت كلتا المعلّمتَين، سيتم استخدامquery
فقط إذا تعذّر على"خرائط Google"العثور على رقم تعريف المكان. وإذا كنت تحاول الربط بشكل محدّد بمؤسسة معيّنة، يكون رقم تعريف المكان هو أفضل ضمان يمكنك من خلاله ربط المكان المناسب. نقترح أيضًا إرسال السمةquery_place_id
عند طلب البحث عن موقع جغرافي معيّن باستخدام إحداثيات خطوط الطول/العرض.
أمثلة البحث
البحث عن الموقع الجغرافي
في عملية البحث عن موقع جغرافي، يمكنك البحث عن موقع جغرافي محدّد باستخدام اسم مكان أو عنوان أو إحداثيات خطوط الطول/العرض مفصولة بفواصل، وتعرض الخريطة الناتجة دبوسًا على ذلك الموقع الجغرافي. هذه الأمثلة الثلاثة توضّح عمليات البحث عن الموقع الجغرافي نفسه، CenturyLink Field (ملعب رياضي في سياتل، واشنطن)، باستخدام قيم مختلفة للموقع الجغرافي.
المثال 1: يؤدي البحث عن اسم المكان "CenturyLink Field" إلى الخريطة التالية:
https://www.google.com/maps/search/?api=1&query=centurylink+field
المثال 2: البحث عن حقل CenturyLink باستخدام إحداثيات خطوط الطول والعرض بالإضافة إلى نتائج معرّف المكان في الخريطة التالية:
المثال 3: يؤدي البحث عن حقل CenturyLink باستخدام إحداثيات خطوط الطول والعرض في الخريطة التالية. يُرجى العِلم أنّ هناك دبوسًا في الخريطة، ولكن لم يتم تقديم معلومات إضافية عن المكان على الخريطة أو في اللوحة الجانبية:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
البحث الفئوي
في البحث الفئوي، يتم تمرير عبارة بحث عامة، ويحاول تطبيق "خرائط Google" العثور على بطاقات البيانات التي تطابق معاييرك بالقرب من الموقع الجغرافي الذي تحدّده.
إذا لم يتم تحديد أي موقع جغرافي، سيحاول تطبيق "خرائط Google" العثور على بطاقات البيانات القريبة من موقعك الجغرافي الحالي. إذا كنت تفضّل تقديم موقع جغرافي لبحث فئة، أدرِج الموقع الجغرافي في سلسلة البحث العامة
(مثل pizza+seattle+wa
).
في هذا المثال، يؤدي البحث عن مطاعم بيتزا في سياتل، واشنطن إلى عرض الخريطة التالية:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
اتجاهات
يعرض إجراء الاتجاهات المسار بين نقطتين أو أكثر من العناصر المحددة على الخريطة، بالإضافة إلى المسافة والسفر.
تكوين عنوان URL للاتجاهات
https://www.google.com/maps/dir/?api=1¶meters
المَعلمات
origin
: تحدّد نقطة البداية التي سيتم عرض الاتجاهات منها. ويتم ضبط الإعدادات التلقائية على موقع البدء الأكثر صلة، مثل الموقع الجغرافي للمستخدم، في حال توفّره. في حال عدم الإنشاء، قد توفّر الخريطة الناتجة نموذجًا فارغًا للسماح للمستخدم بإدخال نقطة الانطلاق. يمكن أن تكون القيمة اسم مكان أو عنوان أو إحداثيات خطوط الطول/العرض مفصولة بفواصل. يجب أن تكون السلسلة مُشفّرة باستخدام عنوان URL، أي أنّه يجب تحويل العنوان، مثل " City;City, NY, NY" إلىCity+Hall%2C+New+York%2C+NY
.ملاحظة: هذه المعلّمة اختيارية، ما لم تحدّد
origin_place_id
في عنوان URL. إذا اخترت تحديدorigin_place_id
، يجب أيضًا تضمينorigin
في عنوان URL.origin_place_id
(اختياري): رقم تعريف مكان هو معرّف نصي يحدّد مكانًا بشكل فريد. إذا كنت تحاول تحديد موقع محدّد بشكل نهائي، يشكّل استخدام رقم تعريف المكان أفضل ضمان لربطه بالمكان الصحيح. ويجب أن تتضمّن عناوين URL التي تستخدِم هذه المعلّمة أيضًاorigin
.destination
: لتحديد نقطة نهاية الاتجاهات. إذا لم تكن هناك خريطة، قد تعرض الخريطة الناتجة نموذجًا فارغًا للسماح للمستخدم بالدخول إلى الوجهة. يمكن أن تكون القيمة اسم مكان أو عنوان أو إحداثيات خطوط الطول/العرض مفصولة بفواصل. يجب أن تكون السلسلة مُشفّرة باستخدام عنوان URL، أي أنّه يجب تحويل العنوان، مثل " City;City, NY, NY" إلىCity+Hall%2C+New+York%2C+NY
.ملاحظة: هذه المعلّمة اختيارية، ما لم تحدّد
destination_place_id
في عنوان URL. إذا اخترت تحديدdestination_place_id
، يجب أيضًا تضمينdestination
في عنوان URL.destination_place_id
(اختياري): رقم تعريف مكان هو معرّف نصي يحدّد مكانًا بشكل فريد. إذا كنت تحاول تحديد موقع محدّد بشكل نهائي، يشكّل استخدام رقم تعريف المكان أفضل ضمان لربطه بالمكان الصحيح. ويجب أن تتضمّن عناوين URL التي تستخدِم هذه المعلَمة أيضًاdestination
.travelmode
(اختيارية): تحدّد طريقة السفر. الخيارات هيdriving
،walking
(التي تفضّل مسارات المشاة والأرصفة، عند توفّرها)،bicycling
(المسارات عبر مسارات الدراجات والشوارع المفضلة عند توفّرها)، أوtransit
. إذا لم يتم تحديدtravelmode
، تعرض"خرائط Google"وضعًا واحدًا أو أكثر من أكثر المسارات ملاءمةً للمسار المحدّد و/أو الإعدادات المفضّلة للمستخدم.dir_action=navigate
(اختيارية): تُشغّل هذه الميزة التنقّل باتّجاهات مفصّلة أو معاينة المسار إلى الوجهة المحدّدة، استنادًا إلى ما إذا كان المصدر متاحًا أم لا. إذا حدَّد المستخدم أصلاً ولم يكن قريبًا من الموقع الجغرافي الحالي للمستخدم، أو كان الموقع الجغرافي الحالي للمستخدم غير متوفّر، تُشغِّل الخريطة معاينة مسار. إذا لم يحدِّد المستخدم أصلاً (في هذه الحالة، ينشأ المصدر تلقائيًا على الموقع الجغرافي الحالي للمستخدم)، أو إذا كان الأصل قريبًا من الموقع الجغرافي الحالي للمستخدم، تُطلق الخريطة ميزة التنقّل باتّجاهات مفصّلة. تجدر الإشارة إلى أن ميزة التنقل غير متاحة في جميع منتجات "خرائط Google " و/أو بين كل الوجهات، وفي هذه الحالة، سيتم تجاهل هذه المعلّمة.waypoints
: تُحدِّد مكانًا واحدًا أو أكثر من الوسيط لتوجيه الاتجاهات خلال الفترة منorigin
إلىdestination
. يمكن تحديد نقاط مسار متعددة باستخدام حرف الأنابيب (|
) لفصل الأماكن (على سبيل المثال،Berlin,Germany|Paris,France
). ويختلف عدد نقاط الطريق المسموح بها باختلاف النظام الأساسي الذي يتم فتح الرابط عليه، مع إمكانية إضافة ما يصل إلى ثلاث نقاط مسار على المتصفحات المتوافقة مع الأجهزة الجوّالة، بحد أقصى تسع نقاط طريق متوافقة. تُعرض نقاط الطريق على الخريطة بالترتيب نفسه الذي تم إدراجها بها في عنوان URL. يمكن أن تكون كل نقطة طريق إما اسم مكان أو عنوان أو إحداثيات خطوط الطول/العرض مفصولة بفواصل. يجب أن تكون السلاسل بترميز URL، أي أنّه يجب تحويل نقاط الطرق، مثل "برلين،ألمانيا|باريس، فرنسا"، إلىBerlin%2CGermany%7CParis%2CFrance
.ملاحظات:
- لا تتوفر نقاط الطرق على جميع منتجات "خرائط Google"، وفي هذه الحالة، سيتم تجاهل هذه المعلَمة.
- هذه المعلّمة اختيارية، ما لم تحدّد
waypoint_place_ids
في عنوان URL. إذا اخترت تحديدwaypoint_place_ids
، عليك أيضًا تضمينwaypoints
في عنوان URL.
waypoint_place_ids
(اختياري): رقم تعريف مكان هو معرّف نصي يحدّد مكانًا بشكل فريد.Waypoint_place_ids
تسمح لك بتقديم قائمة بأرقام تعريف الأماكن لمطابقة قائمةwaypoints
. يجب إدراج أرقام تعريف الأماكن بالترتيب نفسه الذي تشير إليه نقاط الطريق، مع الفصل بينها باستخدام حرف الأنابيب "|
" ( عنوان URL المشفّر باسم%7C
). وإذا كنت تحاول تحديد مؤسسات معيّنة بشكل واضح، تشكّل معرّفات الأماكن أفضل ضمان لربطها بالأماكن المناسبة. ويجب أن تتضمّن عناوين URL التي تستخدِم هذه المعلّمة أيضًاwaypoints
.
أمثلة على الاتجاهات
يُطلق عنوان URL التالي خريطة في وضع الاتجاهات، ويقدم نموذجًا للسماح للمستخدم بالدخول إلى نقطة الانطلاق والوجهة.
https://www.google.com/maps/dir/?api=1
في المثال التالي، يتم تشغيل خريطة باتجاهات الدراجات من "إبرة الفضاء" إلى "سوق بايك بلايس" في سياتل، واشنطن.
يؤدي المثال التالي إلى إطلاق خريطة تتضمّن اتجاهات المشي من Google في سيدني بأستراليا إلى مبنى الملكة فيكتوريا.
يتم الآن عرض خريطة
يعرض إجراء الخريطة خريطة بدون علامات أو اتجاهات.
تكوين عنوان URL للخريطة
https://www.google.com/maps/@?api=1&map_action=map¶meters
المَعلمات
map_action=map
(مطلوبة): تحدّد هذه السياسة نوع عرض الخريطة المطلوب عرضه. تتشارك الخرائط والتجوّل الافتراضي في نقطة النهاية نفسها. لضمان عرض خريطة، يجب تحديدmap_action
على أنهاmap
.center
(اختيارية): تحدّد مركز نافذة الخريطة، وتقبل إحداثيات خطوط الطول/العرض كقيم مفصولة بفواصل (على سبيل المثال،-33.8569,151.2152
).zoom
(اختياري): يتم ضبط مستوى التكبير/التصغير الأولي للخريطة. القيم المقبولة هي أعداد صحيحة كاملة تتراوح بين 0 (العالم بالكامل) و21 (مبانٍ فردية). يمكن أن يختلف الحد الأقصى اعتمادًا على بيانات الخريطة المتاحة في الموقع الجغرافي المحدّد. القيمة التلقائية هي 15.basemap
(اختياري): لتحديد نوع الخريطة التي يتم عرضها. يمكن أن تكون القيمةroadmap
(تلقائية) أوsatellite
أوterrain
.layer
(اختيارية): لتحديد طبقة إضافية لعرضها على الخريطة، في حال توفّرها. يمكن أن تكون القيمة واحدًا مما يلي:none
(تلقائي) أوtransit
أوtraffic
أوbicycling
.
أمثلة على الخرائط
يعرض مثال عنوان URL هذا خريطة Google التلقائية التي تتوسّط الموقع الجغرافي الحالي للمستخدم.
https://www.google.com/maps/@?api=1&map_action=map
يعرِض المثال التالي خريطة ترتكز على Katoomba وNSW
وأستراليا (على -33.712206,150.311941
)، وتضبط المَعلمتَين الاختياريتين zoom
وbasemap
.
عرض بانوراما في "التجوّل الافتراضي"
يتيح لك إجراء البانو تشغيل المشاهد لعرض صور التجوّل الافتراضي كصور بانورامية تفاعلية. وتوفّر كل صورة بانورامية في "التجوّل الافتراضي" عرضًا كاملاً بزاوية 360 درجة من موقع جغرافي واحد. تحتوي الصور على عرض أفقي بزاوية 360 درجة (مع التفاف كامل) و180 درجة للعرض العمودي (من خط مستقيم إلى أسفل). يُطلِق إجراء البانوراما عارضًا يعرِض الصورة البانورامية الناتجة على شكل كرة أرضية مع وضع كاميرا في وسطها. يمكنك التحكّم في تكبير/تصغير الكاميرا واتجاهاتها.
توفّر ميزة "التجوّل الافتراضي من Google" إطلالات بانورامية من مواقع جغرافية محدّدة في جميع مناطق التغطية. تتوفر أيضًا الصور البانورامية التي ساهم بها المستخدمون والمجموعات الخاصة لميزة "التجوّل الافتراضي".
إنشاء عنوان URL لميزة "التجوّل الافتراضي"
https://www.google.com/maps/@?api=1&map_action=pano¶meters
المَعلمات
map_action=pano
(مطلوبة): تحدّد هذه السمة نوع الملف الشخصي المطلوب عرضه. تتشارك الخرائط والتجوّل الافتراضي في نقطة النهاية نفسها. لضمان عرض البانوراما، يجب تحديدaction
على أنهpano
.
يجب أيضًا إضافة إحدى معلّمات عناوين URL التالية:
viewpoint
: يعرض المُشاهد الصورة البانورامية التي تم تصويرها بالقرب من موقعviewpoint
الجغرافي المحدّد كإحداثيات خط الطول/خط العرض مفصولة بفواصل (على سبيل المثال 46.414382,10.013988). بما أنه يتم إعادة تحميل صور "التجوّل الافتراضي" بشكل دوري، وقد يتم التقاط الصور الفوتوغرافية من مواضع مختلفة قليلاً في كل مرة، من الممكن أن يتم التقاط موقعك الجغرافي إلى منظر شامل مختلف عند تعديل الصور.pano
: رقم تعريف البانوراما المحدّد للصورة المطلوب عرضها. إذا حدّدتpano
، يمكنك أيضًا تحديدviewpoint
. لا يتم استخدامviewpoint
إلا إذا لم تتمكّن "خرائط Google" من العثور على رقم تعريف البانوراما. إذا تم تحديدpano
لكن لم يتم العثور عليه، وتم عدم تحديدviewpoint
، لن يتم عرض أي صورة بانورامية. وبدلاً من ذلك، يتم فتح "خرائط Google" في الوضع التلقائي، حيث يتم عرض خريطة تتمركز على الموقع الجغرافي الحالي للمستخدم.
معلّمات عناوين URL التالية اختيارية:
heading
: يشير إلى اتجاه البوصلة بالكاميرا بدرجات في اتجاه عقارب الساعة من الشمال. تتراوح القيم المقبولة من -180 إلى 360 درجة. إذا تم حذف السمة، يتم اختيار عنوان تلقائي استنادًا إلى نقطة عرض (إذا تم تحديدها) لطلب البحث والموقع الجغرافي الفعلي للصورة.pitch
: تحدِّد زاوية الكاميرا أو أعلاها أو أسفلها. يتم تحديد درجة الصوت من درجات بين -90 و90. أمّا القيم الموجبة، فهي زاوية الكاميرا للأعلى، في حين تعمل القيم السلبية على ضبط زاوية الكاميرا للأسفل. ويتم ضبط درجة الصوت التلقائية على 0 استنادًا إلى موضع الكاميرا عند التقاط الصورة. ولهذا السبب، يكون العرض التقديمي المخطط 0، ولكن ليس دائمًا، أفقيًا. على سبيل المثال، بالنسبة إلى صورة تم التقاطها على تل، من المحتمل أن يتم عرض درجة صوت تلقائية غير أفقية.fov
: لتحديد الحقل الأفقي لعرض الصورة. يتم التعبير عن مجال الرؤية بالدرجات، تتراوح بين 10 و100. ويتم ضبط القيمة التلقائية على 90. عند التعامل مع إطار عرض ثابت الحجم، يُعدّ حقل الرؤية مستوى التكبير/التصغير، حيث تشير الأرقام الصغيرة إلى مستوى تكبير أعلى.
أمثلة على "التجوّل الافتراضي"
يعرض المثالان الأولان صورة بانورامية لبرج إيفل. ويستخدم المثال الأول viewpoint
فقط للموقع الجغرافي، ويضبط المعلمات heading
وpitch
وfov
الاختيارية. للمقارنة، يستخدم المثال الثاني رقم تعريف pano
بالإضافة إلى المعلّمات نفسها التي تم إعدادها في المثال الأول. يعرض المثال الثالث صورة بانورامية داخلية.
المثال 1: استخدام viewpoint
فقط لتحديد الموقع الجغرافي.
المثال 2: يتم استخدام معرّف pano
وموقع viewpoint
الجغرافي.
يكون للمعرّف pano
الأولوية على viewpoint
.
في هذا المثال، تم العثور على رقم تعريف بانوراما، لذا يتم تجاهل viewpoint
. يُرجى العِلم أنّ الصورة البانورامية التي يتم عرضها لمعرّف pano
تختلف قليلاً، وليست أحدث من الصورة التي تم العثور عليها باستخدام السمة viewpoint
فقط.
المثال 3: عرض صورة بانورامية للتصميم الداخلي لمطعم Sarastro في لندن بالمملكة المتحدة مع تحديد رقم تعريف بانوراما.
https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA
جارٍ البحث عن رقم تعريف بانوراما
للعثور على رقم تعريف صورة بانورامية معيَّنة، يمكنك استخدام عدة طرق.
- بالنسبة إلى JavaScript، استخدِم فئة StreetViewبانوراما.
- بالنسبة إلى أجهزة Android، استخدِم الفئة العامة StreetViewبانوراماLocation.
- بالنسبة إلى الأجهزة التي تعمل بنظام التشغيل iOS، استخدِم الفئة GMSبانوراما.
- يمكنك أيضًا تقديم طلبات بيانات وصفية باستخدام واجهة برمجة تطبيقات صور "التجوّل الافتراضي" من Google. توفّر طلبات البيانات الوصفية للصور بيانات عن صور "بانوراما" في "التجوّل الافتراضي"، بما في ذلك رقم تعريف البانوراما.
مزيد من الأمثلة
أمثلة على الاتجاهات باستخدام نقاط الطرق
تشغّل أمثلة الاتجاهات التالية "خرائط Google" وتعرض اتجاهات القيادة من باريس وفرنسا إلى شيربورغ وفرنسا عبر توجيهات النقاط التالية:
المدينة، البلد | اسم المكان | معرّف المكان |
---|---|---|
1- فرساي، فرنسا | "قصر فرساي" | ChIJdUyx15R95kcRj85ZX8H8OAU |
2. شارت، فرنسا | كاتدرائية "شارتر" | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3- لو مان، فرنسا | كاتدرائية القديس جوليان من لو مان | ChIJG2LvQNCI4kcRKXNoAsPi1Mc |
4. كان، فرنسا | قلعة كان | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
في أمثلة عناوين URL، يتم تحديد نقاط الطريق بطرق مختلفة حتى تتمكّن من مقارنة الاختلافات في عرض نقاط الطريق على الخرائط الناتجة.
المثال 1: نقاط الطرق المحددة كمدينة، بلد:
المثال 2: نقاط الطرق المحدّدة كأسماء أماكن معيّنة:
المثال 3: نقاط الطرق المحدّدة على أنها مدينة أو بلد، وتوفّر أيضًا waypoint_place_ids
لمؤسسة معيّنة في كل نقطة طريق:
المثال 4: يعرّف نقاط الطريق باعتبارها مدينة أو بلد، ولكنها تسرد نقاط الطريق بترتيب مختلف مقارنةً بالأمثلة السابقة. يشير إلى أن الخريطة تعرض نقاط الطرق بالترتيب الذي تم إدراجها به في عنوان URL.
أمثلة على الخرائط
لعرض خريطة تتضمّن basemap
(قمر صناعي) وlayer
محدد (نقل عام).
أمثلة على "التجوّل الافتراضي"
عرض صورة بانورامية للتجوّل الافتراضي باستخدام مفتاح صورة FIFE كرقم تعريف pano
. تجدر الإشارة إلى أن
معرّف pano
يسبقه الرمز F:.