تنفيذ نوايا تطبيقات التنقّل

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

تتيح فئة Intent لتطبيق التنقّل في "مساعد Google" النوايا التالية:

  • النية من التنقّل
  • القصد من البحث
  • نيّة الإجراء المخصّص

تدفق بيانات الأهداف

الشكل 1: تدفق بيانات الأهداف

المَعلمات في بيانات الأهداف

تتّبع بيانات النية تنسيق معرّف الموارد المنتظم (URI) الذي يحتوي على مَعلمات استنادًا إلى النية التي يتم تمريرها. يتمّ توفير بعض المَعلمات دائمًا في البيانات. وهذا يعني أنّه يمكنك توقّع أن يكون لها قيمة صريحة دائمًا. ومع ذلك، لا يتمّ ضبط قيمة للمَعلمات الاختيارية في البيانات دائمًا. لمزيد من المعلومات، يُرجى الاطّلاع على اختبار البيانات.

الأهداف بلا إنترنت

تتوفّر الصيغ بلا إنترنت لجميع الأهداف المدرَجة في هذه الصفحة. ويمكنك التمييز بينهما من خلال إلحاق .offline بتصميمهما. على سبيل المثال، يستخدم مسار التنقّل مخطّط geo.offline. تشير فلاتر الأهداف هذه في البيان إلى قدرة التطبيق على تنفيذ هذه الإجراءات بلا اتصال بالإنترنت.

استخدِم نية التنقّل لاستيفاء طلب أحد المستخدِمين بالتنقّل إلى وجهة معيّنة. يمكن أن تكون هذه الوجهة موقعًا جغرافيًا واحدًا (عنوان) أو مواقع جغرافية متعددة (مثل المقاهي ومحطات الوقود). تتّبع بيانات النية تنسيق عنوان URL محدّدًا لكلّ نية.

تنسيق النية

تستخدِم فئة Intent التنسيق التالي لقصد تطبيق التنقّل:

الفئة: android.intent.category.DEFAULT

الإجراء:

  • ‫Android Auto ونظام التشغيل Android Automotive: androidx.car.app.action.NAVIGATE
  • أشكال الأجهزة الأخرى: android.intent.action.NAVIGATE

المخطط: geo

أمثلة:

  • geo:0,0?q=Googleplex
  • geo:0,0?q=1600+Amphitheatre+parkway&mode=b&intent=add_a_stop
  • geo:0,0?q=coffee+shop&mode=w&intent=navigation
  • geo:1.1,2.2?q=Starbucks+on+Main+Street&mode=w&intent=navigation

سلوك التطبيق المقترَح: يبدأ التنقّل إلى الموقع الجغرافي المحدّد أو يُطلَب من العميل الاختيار من بين خيارات متعدّدة.

فلاتر أهداف البيان

حدِّد تنسيق النية التالي في ملف بيان تطبيقك لكي يعرف "مساعد Google" أنّ تطبيق التنقّل يمكنه تلقّي نوايا التنقّل.

جميع أشكال الأجهزة باستثناء Android Auto وAndroid Automotive:

<intent-filter>
  <action android:name="android.intent.action.NAVIGATE" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo" />
</intent-filter>

‫Android Auto ونظام التشغيل Android Automotive:

<intent-filter>
  <action android:name="androidx.car.app.action.NAVIGATE" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo" />
</intent-filter>

المَعلمات المقدَّمة

من المتوقّع أن تكون المَعلمات التالية متوفّرة في بيانات نية استخدام تطبيق التنقّل المقدَّمة.

طلب بحث عن الموقع الجغرافي أو الإحداثيات الجغرافية

يحتوي كل طلب بحث عن نية التنقّل على مَعلمة واحدة أو كلتا المَعلمتَين التاليتَين، استنادًا إلى نوع البيانات المطلوبة:

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

    يشير إلى الموقع الجغرافي الذي يحاول المستخدم الانتقال إليه. استخدِم هذه البيانات لتحديد وجهة المستخدِم.

    مفتاح المَعلمة: q
    القيمة: الوجهة التي بحث عنها المستخدم.

    مثال: geo:0,0?q=Golden+Gate+Bridge
    التفسير: يريد المستخدم الانتقال إلى جسر الملك فهد.

  • الإحداثيات الجغرافية (خط العرض وخط الطول)

    يشير إلى إحداثيات محدّدة يستخدمها المستخدم للتنقّل.

    مفتاح المَعلمة: geo:lat,long
    القيمة: الإحداثيات التي بحث عنها المستخدم

    مثال: geo:1.1,2.2?mode=w&intent=navigation
    التفسير: يريد المستخدم الانتقال إلى الإحداثيات (1.1، 2.2).

المَعلمات الاختيارية

يتم وصف المَعلمات الاختيارية المقدَّمة في بيانات نية استخدام تطبيق التنقّل في هذا القسم.

النيّة

تحدِّد نية المستخدِم. إذا لم يتم ضبط هذه المَعلمة، يتم اعتبار navigation هو نية المستخدِم التلقائية.

مفتاح المَعلمة: intent
القيم المحتملة:

  • navigation [القيمة التلقائية] - تستبدل الوجهة وتبدأ التنقّل. استخدِم هذا الإجراء لطلبات البحث مثل الانتقال إلى x.
  • ‫add_a_stop - تُضيف المحطة كوجهة تالية مع الوجهات السابقة. استخدِم هذا الإجراء لطلبات البحث مثل إضافة محطة في x.
  • directions - تعرِض اتجاهات المسار بدون بدء التنقّل. استخدِم هذا الإجراء للطلبات التي تتضمّن عبارات مثل الاتجاهات إلى x.

مثال: geo:47.61594547836694,-122.20373173098756?q=575+Bellevue+Square,+Bellevue,+WA+98004&intent=add_a_stop التفسير: يريد المستخدم إضافة محطة إلى Bellevue Square، Bellevue، بالإحداثيات الحالية [47.6، -122.2].

تجنب

يحدِّد العناصر التي يجب تجنُّبها في التنقّل.

مفتاح المَعلمة: avoid
القيم المحتملة:

  • f - العبّارات
  • ‫h - الطرق السريعة
  • t - رسوم عبور

مثال: geo:0,0?q=googleplex&avoid=tf
التفسير: يريد المستخدم الانتقال إلى Googleplex مع تجنُّب الرسوم والعبارة.

وضع السفر

يمثّل وضع التنقّل وسيلة النقل المحدّدة في طلب البحث من قِبل المستخدِم.

مفتاح المَعلمة: mode
القيم المحتملة:

  • b - دراجة هوائية
  • d - قيادة
  • x - سيارة أجرة
  • l - مركبة ذات عجلتين
  • r - نقل عام
  • ‫w - مشي

مثال: geo:0,0?q=Googleplex&mode=r
التفسير: يريد المستخدم الانتقال إلى Googleplex باستخدام وسائل النقل العامة.

الإدخال

تُستخدَم لتسجيل مصدر الإدخال.

القيم المحتمَلة: مساعد

مثال: geo:47.61594547836694,-122.20373173098756?entry=assistant

القصد من البحث

استخدِم نية بحث للبحث عن طلب بحث وعرض نتائج متعدّدة على طول المسار أثناء القيادة.

تنسيق النية

تستخدِم فئة Intent التنسيق التالي لنيّات البحث:

الفئة: android.intent.category.DEFAULT

الإجراء: android.intent.action.VIEW

المخطط: geo

مثال: geo:0,0?q=restaurants+nearby

سلوك التطبيق المقترَح: فتح قائمة بالمواقع الجغرافية التي تتوافق مع طلب البحث الذي يقدّمه المستخدم

فلاتر أهداف البيان

حدِّد تنسيق النية التالي في ملف بيان تطبيقك لكي يعرف "مساعد Google" أنّ تطبيق التنقّل يمكنه تلقّي نوايا البحث:

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo" />
</intent-filter>

المَعلمات المقدَّمة

من المتوقّع أن تكون المَعلمات التالية متاحة في data intent البحث المقدَّمة.

طلب الموقع الجغرافي

طلب البحث عن الموقع الجغرافي هو الموقع الجغرافي الذي يبحث عنه المستخدم أثناء القيادة. يمكن أن يكون هذا الطلب غير دقيق أو على طول مسار تنقّل نشط.

مفتاح المَعلمة: q
القيمة: عبارة بحث المستخدِم، والتي يمكن أن تكون نوع موقع جغرافي مثل مقهى أو جامعة، ولكن يمكن أن تتضمّن أيضًا كميّات مثل -بالقرب مني أو -بأفضل تقييم.

مثال: geo:0,0?q=restaurants+nearby
التفسير: يريد المستخدم البحث عن المطاعم القريبة.

نيّة الإجراء المخصّص

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

تنسيق النية

تستخدِم فئة Intent التنسيق التالي لنية الإجراء المخصّصة:

الفئة: android.intent.category.DEFAULT

الإجراء: android.intent.action.VIEW

المخطط: geo.action

مثال: geo.action:?act=report&accident_type=major

فلاتر أهداف البيان

حدِّد تنسيق النية التالي في ملف بيان تطبيقك لإعلام "مساعد Google" بأنّ تطبيق التنقّل يمكنه تلقّي طلبات تنفيذ مخصّصة.

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo.action" />
</intent-filter>

المَعلمات المقدَّمة

من المتوقّع أن تكون المَعلمات التالية متاحة في بيانات نية الإجراء المخصّص المقدَّمة:

نوع الإجراء

وهي تحدِّد نوع الإجراء المخصّص الذي يريد المستخدم تنفيذه.

مفتاح المَعلمة: act

أمثلة:

  • geo.action:?act=report_crash&accident_type=major
    التفسير: يريد المستخدم الإبلاغ عن حادث كبير.

  • geo.action:?act=mute
    التفسير: يريد المستخدم كتم صوت التعليمات الصوتية.

  • geo.action:?act=exit_navigation
    التفسير: يريد المستخدم الخروج من مسار التنقّل الحالي.

سلوك التطبيق المقترَح: تنفيذ الإجراء المطلوب في تطبيق التنقّل أو عرض رسالة تفيد بأنّ الإجراء غير متاح

يوضّح الشكل التالي مثالاً على أزواج المفتاح/القيمة في طلب الاستجابة:

تدفّق بيانات نية الإجراء المخصّص

الشكل 2: تدفّق بيانات نية الإجراء المخصّص

زوج المفتاح/القيمة: 

"act": "report_crash"
"road_direction": other_side"

يحتوي كل إجراء مخصّص دائمًا على مَعلمة act كمفتاح. في المثال السابق على الرمز البرمجي، يمكن أن تتضمّن بعض الإجراءات أزواج مفتاح/قيمة إضافية. على سبيل المثال، يتيح act=report_crash استخدام المفتاحَين الإضافيَين accident_type وroad_direction.

يمكن أن يقبل المفتاح accident_type قيمتَين، minor وmajor.

القيم المحتملة

يسرد الجدول القيم المحتملة التي يمكن أن يرسلها "مساعد Google" كإجراء يحاول المستخدم تنفيذه في تطبيق التنقّل.

القيمة الوصف مفاتيح المَعلمات الاختيارية قيم المَعلمات الاختيارية
allow_ferries تغيير الإعدادات المفضّلة للمسار للسماح بعرض العبارات
allow_highways تغيير الإعداد المفضّل للمسار للسماح بالطرق السريعة
allow_tolls تغيير الإعداد المفضّل للمسار للسماح برسوم الطرق
apply_electric_vehicle_connector_filter عرض مواقع شحن المركبات الكهربائية التي تتطابق مع موصل السيارة فقط
apply_electric_vehicle_fast_charging_filter عرض مواقع شحن المركبات الكهربائية التي تتضمّن شواحن سريعة فقط
apply_electric_vehicle_payment_filter عرض مواقع شحن المركبات الكهربائية التي تتطلّب الدفع فقط
avoid_ferries تغيير المسار المفضّل لتجنّب العبّارات
avoid_highways تغيير المسار المفضّل لتجنّب الطرق السريعة
avoid_tolls تغيير المسار المفضّل لتجنّب رسوم العبور
clear_search_results محو نتائج البحث على الخريطة
distance_to_destination عرض المسافة إلى الوجهة
distance_to_next_turn عرض المسافة إلى المنعطف التالي
eta عرض وقت الوصول المقدَّر إلى الوجهة
exit_navigation اخرج من وضع التنقّل أو ألغِه.
follow_mode تغيير طريقة عرض الخريطة إلى وضع التتبّع
go_back الرجوع إلى الإجراء السابق على الخريطة
hide_satellite غيِّر إعدادات الخريطة لإخفاء معلومات القمر الصناعي.
hide_traffic تغيير إعدادات الخريطة لإخفاء معلومات حركة المرور
mute كتم صوت الإرشاد الصوتي
query_current_road عرض الطريق الحالية التي يسلكها المستخدم
query_destination عرض الوجهة
query_next_turn عرض المنعطف التالي
remove_electric_vehicle_connector_filter أزِل الفلترة لمواقع شحن المركبات الكهربائية التي تتطابق مع موصل السيارة.
remove_electric_vehicle_fast_charging_filter إزالة الفلترة لمواقع شحن المركبات الكهربائية التي تتضمّن شواحن سريعة
remove_electric_vehicle_payment_filter أزِل الفلترة لمواقع شحن المركبات الكهربائية التي تتطلب الدفع.
report_crash الإبلاغ عن الأعطال accident_type minor
major
road_direction this_side
other_side
report_hazard الإبلاغ عن المخاطر hazard_type animal
broken_traffic_light
construction
flooding
fog
hail
ice
missing_sign
object_on_road
pothole
roadkill
snow
vehicle
weather
road_direction this_side
other_side
location_on_road on_road
on_shoulder
report_police الإبلاغ عن نشاط الشرطة road_direction this_side
other_side
report_road_closure الإبلاغ عن حالات إغلاق الطرق road_closure_type partial
full
report_traffic الإبلاغ عن عدد الزيارات traffic_type moderate
heavy
standstill
road_direction this_side
other_side
resume_navigation استئناف التنقّل
route_overview عرض نظرة عامة على المسار
show_alternates عرض المسارات البديلة
show_directions_list عرض تعليمات مفصّلة
show_satellite عرض معلومات القمر الصناعي على الخريطة
show_traffic عرض حركة المرور على الخريطة
time_to_destination عرض وقت الوصول المقدَّر إلى الوجهة
time_to_next_turn عرض وقت الوصول المقدَّر إلى المنعطف التالي
unmute فعِّل الإرشاد الصوتي.