البدء

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مقدمة

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

لتشغيل "خرائط 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 على "خرائط 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&parameters

المَعلمات

  • query (مطلوبة): لتحديد الأماكن التي يجب تمييزها على الخريطة. معلَمة طلب البحث مطلوبة لكل طلبات البحث.
    • حدّد المواقع الجغرافية إما كاسم مكان أو عنوان أو إحداثيات خط الطول/خط العرض مفصولة بفواصل. يجب أن تكون السلاسل مشفّرة باستخدام عنوان URL، أي أنّه يجب تحويل العنوان مثل "City; City Hall, New York, NY&quot إلى 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;City, NY, NY&quot إلى 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&quot إلى 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، أي أنّه يجب تحويل نقاط الطرق، مثل "برلين،ألمانيا|باريس، فرنسا&quot، إلى 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 (مطلوبة): تحدّد هذه السياسة نوع عرض الخريطة المطلوب عرضه. تتشارك الخرائط والتجوّل الافتراضي في نقطة النهاية نفسها. لضمان عرض خريطة، يجب تحديد 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.

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 (مطلوبة): تحدّد هذه السمة نوع الملف الشخصي المطلوب عرضه. تتشارك الخرائط والتجوّل الافتراضي في نقطة النهاية نفسها. لضمان عرض البانوراما، يجب تحديد 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