البدء

مقدمة

باستخدام عناوين URL الخاصة بـ "خرائط Google"، يمكنك إنشاء عنوان URL عام ومن عدّة منصات لإطلاق خرائط Google وإجراء عمليات بحث والحصول على الاتجاهات والتنقّل وعرض طُرق عرض الخريطة والصور البانورامية. بنية عنوان URL هي نفسها بغض النظر عن النظام الأساسي المستخدَم.

لست بحاجة إلى مفتاح واجهة برمجة تطبيقات Google لاستخدام عناوين URL في "خرائط Google".

بنية عامة تعمل على عدّة أنظمة أساسية

بصفتك مطورًا لتطبيق 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 وتنفيذ إجراء محدد

لتشغيل "خرائط Google" وتنفيذ إحدى الوظائف المتوافقة اختياريًا، استخدِم مخطط عنوان URL لأحد النماذج التالية بناءً على الإجراء المطلوب:

  • البحث: يمكنك إطلاق إحدى "خرائط Google" التي تعرض دبوسًا لمكان محدّد، أو إجراء بحث عام وإطلاق خريطة لعرض النتائج:
    https://www.google.com/maps/search/?api=1&parameters
  • الاتجاهات - اطلب الاتجاهات وشغِّل "خرائط Google" مع النتائج:
    https://www.google.com/maps/dir/?api=1&parameters
  • عرض خريطة — تشغيل "خرائط Google" بدون علامات أو اتجاهات:
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • عرض بانوراما في "التجوّل الافتراضي" — تشغيل صورة بانورامية تفاعلية:
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

ملاحظة مهمة: تحدِّد المَعلمة api=1 إصدار عناوين URL الخاصة بخرائط Google التي تم تخصيص عنوان URL هذا لها. هذه المَعلمة مطلوبة في كل طلب. القيمة الوحيدة الصالحة هي 1. إذا لم يكن api=1 متوفرًا في عنوان URL، سيتم تجاهل جميع المَعلمات وسيتم تشغيل تطبيق "خرائط Google" التلقائي، إما في متصفّح أو في تطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة، وذلك بناءً على النظام الأساسي المستخدَم (على سبيل المثال، https://www.google.com/maps).

إنشاء عناوين URL صالحة

يجب ترميز عناوين URL بشكل صحيح.

على سبيل المثال، تستخدم بعض المَعلمات حرف الشرطة الرأسية (|) كفاصل، وعليك ترميزه كرمز %7C في عنوان URL النهائي. تستخدم المعلَمات الأخرى قيمًا مفصولة بفواصل، مثل إحداثيات خطوط الطول والعرض، أو المدينة، الولاية. يجب ترميز الفاصلة بالشكل %2C. يُرجى ترميز المسافات باستخدام %20 أو استبدالها بعلامة الجمع (+).

بالإضافة إلى ذلك، تقتصر عناوين URL على 2,048 حرفًا لكل طلب. ويجب الانتباه إلى هذا الحد عند إنشاء عناوين URL.

الإجراءات على الخريطة

تشمل الإجراءات المتاحة على الخريطة ما يلي: البحث، والاتجاهات، وعرض خريطة، وعرض بانوراما من خلال ميزة "التجوّل الافتراضي". ويمكنك تحديد الإجراء في عنوان URL للطلب، بالإضافة إلى المَعلمات المطلوبة والاختيارية. وكما هي الحال في عناوين URL، يمكنك الفصل بين المَعلمات باستخدام رمز العطف اللاتيني (&). بالنسبة إلى كل إجراء، يتم تعداد قائمة المَعلمات وقيمها المحتملة في قسم معلَمات البحث.

بحث

يعرض إجراء البحث نتائج البحث في منطقة الخريطة المرئية. عند البحث عن مكان معيّن، تضع الخريطة الناتجة دبوسًا في الموقع المحدد وتعرض تفاصيل المكان المتاح.

إنشاء عنوان URL للبحث

https://www.google.com/maps/search/?api=1&parameters

المَعلمات

  • query (مطلوبة): لتحديد الأماكن المطلوب تمييزها على الخريطة. معلَمة طلب البحث مطلوبة لجميع طلبات البحث.
    • حدِّد المواقع الجغرافية إما كاسم مكان أو عنوان أو إحداثيات خطي العرض/الطول مفصولة بفواصل. يجب أن تكون السلاسل مرمّزة بعنوان URL، وبالتالي يجب تحويل عنوان مثل "مجلس المدينة، مدينة نيويورك" إلى City+Hall%2C+New+York%2C+NY.
    • حدِّد عبارات البحث العامة كسلسلة بترميز عنوان URL، مثل grocery+stores أو restaurants+in+seattle+wa.
  • query_place_id (اختيارية): رقم تعريف المكان هو معرّف نصي يعرّف مكانًا بشكلٍ فريد. بالنسبة إلى الإجراء search، عليك تحديد query، ولكن يمكنك أيضًا تحديد query_place_id. إذا حدّدت كلتا المَعلمتَين، يتم استخدام query فقط إذا تعذّر على "خرائط Google" العثور على رقم تعريف المكان. إذا كنت تحاول الربط بشكل نهائي بمؤسسة معيّنة، يكون رقم تعريف المكان هو أفضل ضمان لإنشاء رابط يؤدي إلى المكان الصحيح. ننصحك أيضًا بإرسال السمة query_place_id عند طلب البحث عن موقع جغرافي معيّن باستخدام إحداثيات خط العرض/خط الطول.

أمثلة البحث

البحث عن الموقع الجغرافي

عند البحث عن موقع جغرافي، يمكنك البحث عن موقع جغرافي محدّد باستخدام اسم مكان أو عنوان أو إحداثيات خطي العرض/الطول مفصولة بفواصل، وستعرض الخريطة الناتجة دبوسًا في هذا الموقع الجغرافي. توضّح هذه الأمثلة الثلاثة عمليات البحث عن الموقع الجغرافي نفسه، وهو ملعب CenturyLink (ملعب رياضي في سياتل بولاية واشنطن) باستخدام قيم موقع جغرافي مختلفة.

المثال 1: البحث عن اسم المكان "حقل سنترك" في الخريطة التالية:

https://www.google.com/maps/search/?api=1&query=centurylink+field

المثال 2: البحث عن حقل CenturyLink باستخدام إحداثيات خطي الطول والعرض بالإضافة إلى نتائج معرّف المكان في الخريطة التالية:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

المثال 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&parameters

المَعلمات

  • 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 أيضًا.
  • avoid (اختيارية): تحدّد الميزات التي يجب محاولة تجنُّبها في المسار. يمكن ضبطها على خيار واحد أو أكثر من هذه الخيارات، مع الفصل بينها باستخدام حرف فاصلة "," ( بترميز عنوان URL بالصيغة %2C):
    • ferries
    • highways
    • tolls

أمثلة على الاتجاهات

يشغِّل عنوان URL التالي خريطة في وضع الاتجاهات ويوفّر نموذجًا للسماح للمستخدم بإدخال المصدر والوجهة.

https://www.google.com/maps/dir/?api=1

يؤدي المثال التالي إلى إطلاق خريطة تتضمن اتجاهات ركوب الدراجات من برج "الإبرة الفضائية" إلى سوق "بايك بلايس" في مدينة سياتل بولاية واشنطن.

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

في المثال التالي، يتم عرض خريطة تتضمن اتجاهات المشي من Google في سيدني بأستراليا إلى مبنى الملكة فيكتوريا.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking

عرض خريطة

يؤدي إجراء الخريطة إلى عرض خريطة بدون علامات أو اتجاهات.

إنشاء عنوان URL للخريطة

https://www.google.com/maps/@?api=1&map_action=map&parameters

المَعلمات

  • 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

يعرض المثال التالي خريطة تتمركز حول كاتومبا، نيوساوث ويلز، أستراليا (في -33.712206,150.311941)، ويضبط المَعلمتَين الاختياريتَين zoom وbasemap.

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain

عرض بانوراما في ميزة "التجوّل الافتراضي"

يتيح لك إجراء البانوراما إمكانية تشغيل عارض لعرض صور "التجوّل الافتراضي" كصور بانورامية تفاعلية. توفر كل بانوراما في ميزة "التجوّل الافتراضي" عرضًا كاملاً بزاوية 360 درجة من موقع واحد. تحتوي الصور على عرض أفقي بزاوية 360 درجة (الالتفاف الكامل) والعرض الرأسي بزاوية 180 درجة (من مباشرة إلى أسفل). عند تنفيذ البانوراما، يتم تشغيل عارض يعرض الصورة البانورامية الناتجة على شكل كرة في منتصفها. يمكنك التحكم في الكاميرا للتحكّم في التكبير أو التصغير واتجاهها.

توفّر ميزة "التجوّل الافتراضي من Google" إطلالات بانورامية من مواقع جغرافية محدّدة في جميع أنحاء منطقة التغطية. تتوفر أيضًا الصور البانورامية التي يساهم بها المستخدمون ومجموعات خاصة من "التجوّل الافتراضي".

إنشاء عنوان URL لميزة "التجوّل الافتراضي"

https://www.google.com/maps/@?api=1&map_action=pano&parameters

المَعلمات

  • 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 فقط لتحديد الموقع الجغرافي.

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

المثال 2: يستخدم رقم تعريف pano وموقع viewpoint الجغرافي. ويكون لرقم تعريف pano الأولوية على viewpoint. في هذا المثال، يتم العثور على معرّف البانوراما، وبالتالي يتم تجاهل viewpoint. يُرجى ملاحظة أنّ الصورة البانورامية التي يتم عرضها لمعرّف pano مختلفة قليلاً، وأكثر حداثة من الصورة التي تم العثور عليها باستخدام viewpoint فقط.

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

المثال 3: يعرض صورة بانورامية من الداخل لمطعم Sarastro في لندن بالمملكة المتحدة، مع تحديد معرّف بانوراما.

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

العثور على معرّف بانوراما

للعثور على معرّف صورة بانورامية معينة، هناك العديد من الطرق التي يمكنك استخدامها.

مزيد من الأمثلة

أمثلة على الاتجاهات باستخدام نقاط الطرق

في ما يلي أمثلة على الاتجاهات لإطلاق "خرائط Google" وعرض اتجاهات القيادة من باريس في فرنسا إلى شيربورغ في فرنسا، مع التوجيه خلال نقاط الطريق التالية:

المدينة، البلداسم المكانمعرّف المكان
1- فرساي، فرنسا قصر فرساي ChIJdUyx15R95kcRj85ZX8H8OAU
2. شارتر، فرنسا كاتدرائية شارتر ChIJKzGHdEgM5EcR_OBTT3nQoEA
3- لو مان، فرنسا كاتدرائية سانت جوليان من لو مان ChIJG2LvQNCI4kcRKXNoAsPi1Mc
4. كاين، فرنسا قلعة كاين ChIJ06tnGbxCCkgRsfNjEQMwUsc

في نماذج عناوين URL، يتم تحديد نقاط الطرق بطرق مختلفة لتتمكّن من مقارنة الاختلافات في عرض نقاط الطرق على الخرائط الناتجة.

المثال 1: نقاط الطرق المعرّفة كالمدينة، والبلد:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

المثال 2: نقاط الطرق المحددة على أنها أسماء أماكن محددة:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

المثال 3: نقاط الطرق التي يتم تحديدها على أنّها مدينة وبلد، وتقدّم أيضًا السمة waypoint_place_ids لمنشأة معيّنة في كل نقطة طريق:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

المثال 4: تحدد نقاط الطرق على أنّها "مدينة" أو "بلد"، مع إدراج نقاط الطرق بترتيب مختلف مقارنةً بالأمثلة السابقة. توضح أن الخريطة تعرض نقاط الطريق بترتيب إدراجها في عنوان URL.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

أمثلة على الخريطة

عرض خريطة مع basemap (القمر الصناعي) وlayer (القمر الصناعي) محدّدَين

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

أمثلة على "التجوّل الافتراضي"

يتم عرض بانوراما في إطار "التجوّل الافتراضي" باستخدام مفتاح صورة FIFE كمعرّف pano. يُرجى العلم أنّ معرّف pano يأتي في البداية بالحرف F:.

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55