توجيه المستخدمين إلى تفاصيل الأماكن واتجاهات الوصول إليها في "خرائط Google" باستخدام عنوان URL الخاص بخرائط Google أو Places API

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

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

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

عنوان URL هذا الخاص بخرائط Google صالح لفتح "خرائط Google" وعرض موقع جغرافي استنادًا إلى خط العرض وخط الطول. ومع ذلك، لا يوفّر هذا الإجراء للمستخدمين تفاصيل حول مكان معيّن.

البحث باستخدام خط العرض وخط الطول فقط
البحث باستخدام خط العرض وخط الطول فقط

ربط تطبيقك بسلاسة بخرائط Google من خلال عناوين URL دقيقة

فتح صفحة "تفاصيل المكان" على "خرائط Google"
يوجّه عنوان URL في "خرائط Google" الذي يتضمّن اسم مكان فريدًا المستخدمين إلى صفحة تفاصيل ذلك المكان على "خرائط Google"

توفّر "منصّة خرائط Google" طريقتَين أساسيتَين لإنشاء عناوين URL دقيقة: Places API (الإصدار الجديد) التي تتطلّب مفتاح واجهة برمجة التطبيقات، وعناوين URL في "خرائط Google" التي تكون مجانية ولا تتطلّب مفتاحًا. تتناول الحلول التالية سيناريوهات وحالات استخدام مختلفة:

تعرض GMP Places API(الإصدار الجديد) مجموعة شاملة من المعلومات عن مكان معيّن. عند طلب حقل googleMapsUri أو googleMapsLinks (من خلال تحديده في قناع الحقل)، يتضمّن ردّ واجهة برمجة التطبيقات عنصر مكان. يحتوي هذا العنصر على عناوين URL منسَّقة مسبقًا، ويمكن استخدامها لفتح طريقة العرض المقابلة مباشرةً، مثل عرض تفاصيل المكان، في "خرائط Google".

مثال:

طلب تفاصيل المكان

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

ردّ على تفاصيل المكان:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

ChIJ3S-JXmauEmsRUcIaWtf4MzE في المثال أعلاه هو معرّف المكان لدار الأوبرا في سيدني. معرّف المكان هو معرّف نصي يحدد مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google".

استرداد أرقام تعريف الأماكن بدون أي تكلفة

لاسترداد أرقام تعريف الأماكن آليًا، يمكنك استخدام وظيفة Places API: البحث النصي(رقم التعريف فقط). هذه طريقة مجانية للحصول على أرقام تعريف الأماكن. اطّلِع على مزيد من المعلومات عن رقم تعريف المكان وطلب Place API(الإصدار الجديد).

طلب البحث النصي في Places API(رقم التعريف فقط):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

استجابة البحث النصي في Places API(رقم التعريف فقط):

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

يمكن أيضًا استرداد أرقام تعريف الأماكن عندما ينقر المستخدم على نقطة اهتمام على الخرائط. اطّلِع على مزيد من التفاصيل عن رموز نقاط الاهتمام القابلة للنقر(JavaScript وAndroid وiOS).

التنفيذ

عند استخدام Places API، يمكن للمطوّرين ببساطة استخراج الحقل googleMapsUri أو googleMapsLinks من الاستجابة واستخدامه لبدء العرض المقابل في تطبيق "خرائط Google" أو في متصفّح إذا لم يكن التطبيق مثبّتًا.

الميزة الوصف
directionsUri رابط لفتح "خرائط Google" لعرض الاتجاهات من الموقع الجغرافي الحالي للمستخدم إلى هذا المكان
placeUri رابط لفتح "خرائط Google" في صفحة تفاصيل هذا المكان
writeAReviewUri رابط لفتح "خرائط Google" للانتقال إلى صفحة كتابة المراجعة لهذا المكان
reviewsUri رابط لفتح "خرائط Google" في صفحة المراجعات لهذا المكان
photosUri رابط لفتح "خرائط Google" في صفحة الصور لهذا المكان

اطّلِع على إرشادات المطوّرين وجرِّب الميزة اليوم.

استخدام عناوين URL في "خرائط Google"

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

في ما يلي الإجراءات المتاحة على الخريطة:

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

  • تؤدي وظيفة "الاتجاهات" إلى تشغيل تطبيق "خرائط Google" أو في متصفّح إذا لم يكن التطبيق مثبّتًا لعرض الاتجاهات بين النقاط أو تفعيل التنقل خطوة بخطوة على "خرائط Google" للأجهزة الجوّالة.

  • تتيح لك وظيفة البانوراما في "التجوّل الافتراضي" تشغيل أداة عرض لعرض صور "التجوّل الافتراضي" كبانوراميات تفاعلية.

يُرجى الانتقال إلى مستندات المطوّرين حول عناوين URL في "خرائط Google" للاطّلاع على المزيد من الدوال والأمثلة.

سنوضّح هنا وظيفتَين رئيسيتين لعناوين URL في "خرائط Google":

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

  • تقديم الاتجاهات باستخدام عناوين URL في "خرائط Google": يشرح هذا القسم كيفية إنشاء عناوين URL تقدّم الاتجاهات بين المواقع الجغرافية، بما في ذلك الاتجاهات التي تتضمّن نقاط طريق متعددة واتجاهات التنقّل المفصّلة.

عرض تفاصيل المكان على "خرائط Google"

تأخذ دالة البحث مَعلمتَين لإكمال البحث عن الأماكن، وهما query(مطلوبة) وquery_place_id(اختيارية).

المَعلمة query مطلوبة لجميع طلبات البحث. يقبل هذا الحقل اسمًا لمكان أو إحداثيات خطوط العرض/الطول مفصولة بفواصل أو عبارة بحث عامة.

بنية عنوان URL للبحث: 

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

السيناريو 1: عرض تفاصيل مكان لاسم مكان فريد 

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
 في هذا المثال، يتم تحديد اسم المكان فقط. يفتح عنوان URL هذا صفحة تفاصيل دار أوبرا سيدني.

فتح صفحة "تفاصيل المكان" على "خرائط Google"
البحث عن اسم مكان وعرض تفاصيله

لنفترض الآن أنّ هناك مكانًا يحمل اسمًا غير فريد. ماذا يحدث عند البحث فقط باستخدام هذا الاسم غير الفريد؟ اطّلِع على السيناريو التالي.

السيناريو 2: البحث عن أماكن باسم غير فريد 

https://www.google.com/maps/search/?api=1&query=7-Eleven

بما أنّ اسم المكان ليس فريدًا، يفتح عنوان URL هذا قائمة بمواقع 7-Eleven القريبة ضمن مساحة العرض. ويمكن للمستخدمين بعد ذلك اختيار متجر محدّد للاطّلاع على تفاصيله.

افتح صفحة "قائمة الأماكن" على "خرائط Google".
صفحة قائمة الأماكن للبحث عن اسم غير فريد

لتجنُّب قائمة المواقع الجغرافية والوصول مباشرةً إلى صفحة تفاصيل معيّنة، يمكنك استخدام طريقة أكثر دقة. راجِع المثال التالي.

السيناريو 3: عرض تفاصيل مكان لاسم مكان غير فريد

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

الطريقة 1: استخدام طلب بحث دقيق يتضمّن اسم المكان وعنوانه 

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

في عنوان URL هذا، تم تنسيق المَعلمة query على أنّها اسم مكان، عنوان. ويساعد ذلك في narrowed down the search and directly link to the intended location.

الطريقة 2: استخدام رقم تعريف المكان

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". 

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

في هذه الحالة، ChIJGcmcg7ZC1moRAOacd3HoEwM هو المعرّف الفريد للمكان المعنيّ. لا تزال المَعلمة query مطلوبة، ولكن لن يتم استخدامها إلا إذا تعذّر على "خرائط Google" العثور على معرّف المكان.

السيناريو 4: عرض تفاصيل المكان باستخدام إحداثيات خط العرض وخط الطول بالإضافة إلى معرّف المكان

يضمن استخدام رقم تعريف المكان أن تعرض "خرائط Google" معلومات مفصّلة عن المكان.

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
صفحة تفاصيل المكان باستخدام خط العرض وخط الطول ورقم تعريف المكان
صفحة تفاصيل المكان باستخدام خط العرض وخط الطول ورقم تعريف المكان

استرداد أرقام تعريف الأماكن بدون أي تكلفة

لاسترداد أرقام تعريف الأماكن آليًا، يمكنك استخدام وظيفة Places API: البحث النصي(رقم التعريف فقط). هذه طريقة مجانية للحصول على أرقام تعريف الأماكن. اطّلِع على مزيد من المعلومات عن رقم تعريف المكان وطلب Place API(الإصدار الجديد).

طلب البحث النصي في Places API(رقم التعريف فقط): 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

استجابة البحث النصي في Places API(رقم التعريف فقط): 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

يمكن أيضًا استرداد أرقام تعريف الأماكن عندما ينقر المستخدم على نقطة اهتمام على الخرائط. اطّلِع على مزيد من التفاصيل عن رموز نقاط الاهتمام القابلة للنقر(JavaScript وAndroid وiOS).

الخاتمة

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

  • query=PLACE_NAME, ADDRESS
  • query=PLACE_NAME&query_place_id=PLACE_ID

تجنَّب استخدام إحداثيات خط الطول/العرض فقط في المَعلمة query عندما يكون هدفك هو عرض تفاصيل مكان معيّن. لن تؤدي التنسيقات مثل query=latitude,longitude أو query=PLACE_NAME,latitude,longitude أو query=ADDRESS,latitude,longitude بشكلٍ منتظم إلى صفحة تفاصيل المكان المطلوبة. بدلاً من ذلك، سيظهر خطا الطول والعرض للموقع الجغرافي.

البحث حسب الفئة باستخدام عناوين URL في "خرائط Google"

في البحث حسب الفئة، تُدخل عبارة بحث عامة، وتحاول "خرائط Google" العثور على بيانات تتطابق مع معاييرك بالقرب من الموقع الجغرافي الذي تحدّده. إذا لم يتم تحديد موقع جغرافي، تحاول "خرائط Google" العثور على بيانات بالقرب من موقعك الجغرافي الحالي.

السيناريو 1: البحث عن الأماكن المجاورة

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
البحث حسب الفئة: الأماكن المجاورة
البحث حسب الفئة: الأماكن القريبة

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

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

بنية عنوان URL الخاص بالاتّجاهات: 

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

السيناريو 1: العثور على أفضل مسار من الموقع الجغرافي الحالي للمستخدم إلى وجهة معيّنة

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

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

في عنوان URL هذا، تم حذف origin. عند حذف origin، يتم ضبط المسار تلقائيًا على الموقع الجغرافي الأكثر صلة بالبداية، مثل الموقع الجغرافي للجهاز، إذا كان متاحًا. وإذا لم يكن هناك مصدر، تقدّم الخريطة الناتجة نموذجًا للسماح للمستخدم بإدخال المصدر. يمكن أن تكون قيمة نقطة المصدر والوجهة إما اسم مكان أو عنوان أو إحداثيات خطوط العرض/الطول مفصولة بفواصل.

travelmode هي مَعلمة اختيارية. يحدِّد طريقة السفر. يمكن ضبط هذه المَعلمة على النحو التالي:

  • القيادة
  • المشي
  • ركوب الدراجات
  • درّاجة نارية
  • النقل العام

في حال عدم تحديد طريقة سفر، تعرض "خرائط Google" طريقة واحدة أو أكثر من أكثر الطرق صلة بالمسار المحدّد و/أو الإعدادات المفضّلة للمستخدم.

يمكن للمطوّرين أيضًا تحديد أرقام تعريف الأماكن باستخدام المَعلمة origin_place_id وdestination_place_id. إنّ استخدام رقم تعريف المكان هو أفضل ضمان لتوجيه المستخدمين إلى المكان الصحيح.

استرداد أرقام تعريف الأماكن بدون أي تكلفة

لاسترداد أرقام تعريف الأماكن آليًا، يمكنك استخدام وظيفة Places API: البحث النصي(رقم التعريف فقط). هذه طريقة مجانية للحصول على أرقام تعريف الأماكن. اطّلِع على مزيد من المعلومات عن رقم تعريف المكان وطلب Place API(الإصدار الجديد).

طلب البحث النصي في Places API(رقم التعريف فقط): 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

استجابة البحث النصي في Places API(رقم التعريف فقط): 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

يمكن أيضًا استرداد أرقام تعريف الأماكن عندما ينقر المستخدم على نقطة اهتمام على الخرائط. اطّلِع على مزيد من التفاصيل عن رموز نقاط الاهتمام القابلة للنقر(JavaScript وAndroid وiOS).

الاتجاهات من الموقع الجغرافي الحالي للمستخدم
الاتجاهات من الموقع الجغرافي الحالي للمستخدم

السيناريو 3: توفير اتجاهات مفصّلة للتنقّل

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

سيؤدي ضبط dir_action=navigate في عنوان URL إلى تشغيل "خرائط Google" في وضع التنقّل المفصّل إذا كان الموقع الجغرافي الحالي للمستخدم(الموقع الجغرافي للجهاز) متاحًا ويكون مُستخدَمًا كمصدر (إما مقدَّمًا صراحةً أو مُستخدَمًا ضمنيًا عند حذف مَعلمة المصدر). بخلاف ذلك، سيتم عرض معاينة للمسار.

يتم تشغيل ميزة "الاتّجاهات المفصّلة" عند ضبط dir_action=navigate و:

  • تم تحديد المصدر وهو قريب من الموقع الجغرافي الحالي للمستخدم
  • تم حذف المصدر وأصبح الموقع الجغرافي الحالي للمستخدم متاحًا

يتم تشغيل ميزة "معاينة المسار" في الحالات التالية:

  • لم يتم ضبط dir_action=navigate
  • تم ضبط dir_action=navigate وتم تحديد المصدر، ويكون المصدر غير قريب من الموقع الجغرافي الحالي للمستخدم
  • تم ضبط dir_action=navigate وتم حذف المصدر، ولا يتوفّر الموقع الجغرافي الحالي للمستخدم

يُرجى العلم أنّ ميزة التنقّل غير متاحة في جميع منتجات "خرائط Google"، مثل "خرائط Google" على الويب، و/أو بين جميع الوجهات. وفي هذه الحالات، سيتم تجاهل هذه المَعلمة.

التنقّل باتّجاهات مفصّلة معاينة المسار
الاتّجاهات المفصّلة
معاينة المسار

الخاتمة

من خلال إنشاء عناوين URL صحيحة في "خرائط Google"، يمكنك ضمان حصول المستخدمين على المعلومات الصحيحة التي يحتاجون إليها بسرعة وكفاءة.

  • حدِّد الوجهة دائمًا واستخدِم رقم تعريف المكان كلما أمكن ذلك للحصول على دقة مضمونة.

  • عندما يكون الهدف هو توفير تنقّل فوري، أدرِج المَعلمة dir_action=navigate لبدء التنقّل باتجاهات مفصّلة. سيبدأ التنقّل من الموقع الجغرافي الحالي للمستخدم إذا كان الموقع الجغرافي للجهاز متاحًا ومستخدَمًا كنقطة منشأ (إما يتم ضبطه صراحةً أو حذفه)

اختيار النهج المناسب لتطبيقك

لديك خياران أساسيان: الاستفادة من عناوين URL المنسَّقة مسبقًا التي تقدّمها Places API أو إنشاء عناوين URL في "خرائط Google" يدويًا في تطبيقك. ولكل أسلوب مجموعة من المزايا والعيوب.

‫Places API:

  • يقدّم الحقلان googleMapsUri وgoogleMapsLinks في استجابة "تفاصيل المكان" عناوين URL جاهزة للاستخدام. ويؤدي ذلك إلى تقليل وقت التطوير والحدّ من خطر حدوث أخطاء في تنسيق عنوان URL.

  • يوفّر هذا الخيار قدرة أقل على التحكّم في ضبط الاتجاهات. على الرغم من أنّ googleMapsLinks يوفّر الاتجاهات الأساسية، إلا أنّه لا يتيح استخدام نقاط الطريق أو التخصيص المتقدّم. بالإضافة إلى ذلك، من الصعب نسبيًا تفعيل ميزة التنقّل من خلال التوجيهات الصوتية مباشرةً.

عناوين URL في "خرائط Google":

  • يوفّر مرونة أكبر وإمكانية تحكّم أكبر. يمكن للمطوّرين إنشاء عناوين URL لعرض تفاصيل الأماكن وضبط جوانب مختلفة من الاتجاهات، بما في ذلك إضافة نقاط الطريق وتحديد وسائل النقل وبدء التنقّل بالتفصيل.

  • يتطلب فهمًا أعمق لمَعلمات عناوين URL وبنيتها. يزيد إنشاء التقارير يدويًا من احتمالية حدوث أخطاء إذا لم يتم تنفيذه بعناية.

تحسين عناوين URL في "خرائط Google" باستخدام مَعلمات نظام مراقبة الزيارات من Urchin

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

بالنسبة إلى المَعلمة utm_source، استخدِم اسم تطبيقك. يجب أن تعكس المَعلمة utm_campaign الإجراء المقصود للمستخدِم، مثل "location_sharing" أو "place_details_search" أو "directions_request".

على سبيل المثال، قد يظهر عنوان URL الذي يتضمّن مَعلمات نظام مراقبة الزيارات من Urchin على النحو التالي: 

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

يساعدنا استخدام هذه المَعلمات باستمرار في تحديد مجالات التحسين، وتحديد المشاكل وحلّها بفعالية أكبر، وتقديم تجربة أفضل لجميع المستخدمين في النهاية.

الخطوات التالية

مراجع إضافية مقترَحة:

المساهمون

المؤلفون الرئيسيون:

تيريسا تشين | "خرائط Google" مهندسة حلول المنصة