Class

INGetRideStatusIntent

A request for the current status of a previously booked ride.

Overview

When the status of a booked ride is requested, SiriKit sends an INGetRideStatusIntent object to your handler object. Upon receiving this intent, fetch the ride status and return it in your response object. The intent object has no additional parameters.

To handle this intent, the handler object in your Intents extension must adopt the INGetRideStatusIntentHandling protocol. Your handler should confirm the request and create an INGetRideStatusIntentResponse object with the status of the ride.

For a list of other intents in the ride booking domain, see INRidesharingDomainHandling.

Additional Intent Attributes

Table 1 lists additional attributes of this intent object.

Table 1

Get ride status intent attributes

Attribute

Description

Supported by

Siri, Maps

Always requires unlocked device

No

Apps can optionally ask the user to unlock the device before handling this intent. To require unlocking of the device, include the name of this class in the IntentsRestrictedWhileLocked key of your Intents extension’s Info.plist file.

Example Phrases

There are many ways in which users can ask Siri for the status of a ride. Table 2 provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list is not exhaustive and Siri may recognize many other phrases.

Table 2

Siri phrases that trigger a request for a ride’s status

Locale

Example 1

Example 2

en

How far away is my driver on <appName>

zh_CN

我的<appName>多久到

zh_HK

<appName>搵吓幾時到

喺滴滴出行問吓司機架車幾時到

zh_TW

我的<appName>什麼時候到

yue_CN

喺<appName>揾吓几时到

喺滴滴出行问吓司机架车几时到

ar

كم المسافة الى <appName> الخاص بي

كم بعد <appName> الخاص بي

da

hvor er det jeg hentes af <appName>

hvor længe endnu for <appName>

de

Ist mein <appName> in der Nähe

Ist mein <appName> noch weit weg

es

A qué hora llega mi <appName>

Qué tan lejos está mi <appName>

fi

Koska mun <appName> saapuu

Kuinka kaukana mun <appName> on

fr

Où est mon chauffeur <appName>

quand arrive mon <appName>

he

תוך כמה זמן יגיע <appName>

כמה רחוק ה<appName> שלי

it

Quanto è lontano il mio autista <appName>

Quando arriva il mio <appName>

ja

<appName>の車はいつ来るの

<appName>のドライバーはどこにいるの

ko

<appName> 타려면 얼마나 걸려

내가 부른 <appName> 언제 와

ms

Berapa jauh pemandu <appName> saya?

Bila <appName> saya tiba

nb

Hvor langt unna er <appName> sjåføren

Når ankommer bilen fra <appName>

nl

Hoe ver weg is mijn bestuurder van <appName>

Is mijn <appName> nog ver weg

pt

Quão longe está meu motorista do <appName>

Quanto tempo vai demorar meu <appName>

ru

Далеко ли мой <appName>

Как скоро я могу получить <appName>

sv

Är min <appName> här snart

Hur långt bort är min <appName>

th

<appName> อยู่ไกลแค่ไหน

จะได้ <appName> เมื่อไหร่

tr

<appName> beni ne zaman alabilir

Daha ne kadar beklemem lazım <appName>'in beni alması için

In the preceding examples, <appName> represents the name of the app whose Intents extension gets the ride status. If your app uses custom names for ride options, you can tell SiriKit about those names using the global vocabulary file.

Topics

Initializing an Intent Object

init()

Initializes the get ride status intent object.

Relationships

Inherits From

Conforms To

See Also

Get the Ride Status

protocol INGetRideStatusIntentHandling

The handler interface for fetching the status of the user’s current ride.

class INGetRideStatusIntentResponse

Your app’s response to a get ride status intent.

protocol INGetRideStatusIntentResponseObserver

An interface for providing updated status for an active ride.