البدء

المقدمة

باستخدام عناوين 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 وتنفيذ إجراء معين

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

  • بحث Google — تشغيل خريطة 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 للخرائط التي تم تخصيص عنوان 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&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 Field (استاد رياضي في سياتل، واشنطن)، باستخدام قيم موقع جغرافي مختلفة.

المثال 1: يؤدي البحث عن اسم المكان "CenturyLink Field" إلى عرض الخريطة التالية:

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.

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

يفتح عنوان 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

يوضّح المثال التالي خريطة تتمركز حول كاتومبا، NSW، أستراليا (في -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