المقدمة
باستخدام عناوين URL للخرائط، يمكنك إنشاء عنوان 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" مثبّتًا، يتم تشغيل عنوان 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 لها. هذه المعلَمة مطلوبة في كل طلب. القيمة الصالحة الوحيدة هي 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+Hall%2C+New+York%2C+NY. - حدِّد عبارات البحث العامة كسلسلة
بترميز عنوان URL، مثل
grocery+storesأوrestaurants+in+seattle+wa.
- حدد المواقع إما كاسم مكان، أو عنوان، أو إحداثيات
خط العرض/الطول مفصولة بفواصل. يجب أن تكون السلاسل مشفرة باستخدام عنوان URL، وبالتالي يجب تحويل عنوان مثل "دار البلدية، دبي، دبي" إلى
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+Hall%2C+New+York%2C+NY.ملاحظة: هذه المعلمة اختيارية، إلا إذا حدّدت
origin_place_idفي عنوان URL. إذا اخترت تحديدorigin_place_id، عليك أيضًا تضمينoriginفي عنوان URL.origin_place_id(اختياري): رقم تعريف المكان هو معرّف نصي يعرّف المكان بشكل فريد. إذا كنت تحاول تحديد مؤسسة محدّدة، من الأفضل استخدام معرّف المكان لإدراج رابط إلى المكان الصحيح. يجب أن تتضمّن عناوين URL التي تستخدم هذه المعلَمة أيضًاorigin.destination: لتحديد نقطة نهاية الاتجاهات. وفي حال عدم توفّر أيٍّ منها، قد توفّر الخريطة الناتجة نموذجًا فارغًا للسماح للمستخدم بالدخول إلى الوجهة. يمكن أن تكون القيمة إما اسم مكان أو عنوانًا أو إحداثيات خطوط الطول/دوائر العرض المفصولة بفواصل. من المفترض أن تكون السلسلة مشفّرة حسب عنوان URL، لذا يجب تحويل عنوان مثل "دار البلدية، دبي، دبي" إلى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(مطلوبة): تحدّد هذه السمة نوع عرض الخريطة المطلوب عرضه. تتشارك خرائط Google والتجوّل الافتراضي نفس نقطة النهاية. لضمان عرض خريطة، يجب تحديد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
يوضّح المثال التالي خريطة تتمركز حول كاتومبا، 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(مطلوبة): تحدّد هذه السمة نوع العرض المطلوب عرضه. تتشارك خرائط Google والتجوّل الافتراضي نفس نقطة النهاية. لضمان عرض صورة بانورامية، يجب تحديد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، استخدِم فئة StreetViewPanorama.
- بالنسبة إلى نظام التشغيل Android، يمكنك استخدام الفئة العامة StreetViewPanoramaLocation.
- بالنسبة إلى الأجهزة التي تعمل بنظام التشغيل iOS، استخدِم فئة GMSPanorama.
- يمكنك أيضًا تقديم طلبات بيانات وصفية باستخدام واجهة برمجة تطبيقات صور "التجوّل الافتراضي من 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:.
