Class

INGetRideStatusIntent

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

Declaration

class INGetRideStatusIntent : INIntent

Overview

When there is a request for the status of a booked ride, 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.

Additional Intent Attributes

Table 1 lists additional attributes of this intent object.

Table 1

Get ride status intent attributes

Attribute

Description

Supported by

Siri Intents, 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

Users can ask Siri for the status of a ride in a variety of ways. Table 2 provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list isn’t 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>多久到

我的<appName>什么时候到

zh_HK

<appName>搵吓幾時到

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

zh_TW

我的<appName>什麼時候到

<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 Table 2, <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.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software