- Action ID
actions.intent.GET_CHARGING_STATION
- Description
- Get charging station. May specify an app name or location.
Locale support
Functionality
|
Locales
|
Preview creation using App Actions test tool
|
en-US
|
User invocation from Google Assistant
|
en-US
|
Example queries
en-US
- Find charging station on ExampleApp
- Find charging station near SFO on ExampleApp
Other supported fields
The following fields represent information that users often provide to
disambiguate their needs or otherwise improve their results:
chargingStation.@type
chargingStation.address
chargingStation.name
chargingStation.geo.@type
chargingStation.geo.latitude
chargingStation.geo.longitude
We recommend
implementing Android
widgets
for this built-in intent. A widget presents information or
interaction options from your app to improve user engagement in Google
Assistant. Widgets are available for App Actions implementations using
shortcuts.xml
.
If you have a legacy App Actions implementation using
actions.xml
, use
Android slices
instead. We recommend
migrating
your
implementation to
shortcuts.xml
to take advantage of widgets
fulfillment and other improvements.
Supported text values by field
chargingStation.geo.@type
Sample XML files
For information about the
shortcuts.xml
schema, see
Create shortcuts.xml
.
Handle BII parameters
shortcuts.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- This is a sample shortcuts.xml -->
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<capability android:name="actions.intent.GET_CHARGING_STATION">
<intent
android:action="android.intent.action.VIEW"
android:targetPackage="YOUR_UNIQUE_APPLICATION_ID"
android:targetClass="YOUR_TARGET_CLASS">
<!-- Eg. name = "Googleplex" -->
<parameter
android:name="chargingStation.name"
android:key="name"/>
<!-- Eg. address = "1600 Amphitheatre Pkwy, Mountain View, CA 94043" -->
<parameter
android:name="chargingStation.address"
android:key="address"/>
<!-- Eg. latitude = "37.3861" -->
<parameter
android:name="chargingStation.geo.latitude"
android:key="latitude"/>
<!-- Eg. longitude = "-122.084" -->
<parameter
android:name="chargingStation.geo.longitude"
android:key="longitude"/>
</intent>
</capability>
</shortcuts>
actions.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- This is a sample actions.xml -->
<actions>
<action intentName="actions.intent.GET_CHARGING_STATION">
<fulfillment urlTemplate="myapp://custom-deeplink{?name,address,latitude,longitude}">
<!-- e.g. name = "Googleplex" -->
<!-- (Optional) Require a field eg.name for fulfillment with required="true" -->
<parameter-mapping urlParameter="name" intentParameter="chargingStation.name" required="true" />
<!-- e.g. address = "1600 Amphitheatre Pkwy, Mountain View, CA 94043" -->
<parameter-mapping urlParameter="address" intentParameter="chargingStation.address" />
<!-- e.g. latitude = "37.3861" -->
<parameter-mapping urlParameter="latitude" intentParameter="chargingStation.geo.latitude" />
<!-- e.g. longitude = "-122.084" -->
<parameter-mapping urlParameter="longitude" intentParameter="chargingStation.geo.longitude" />
</fulfillment>
<!-- Provide a fallback fulfillment with no required parameters. For example, to your app search or router deeplink -->
<fulfillment urlTemplate="myapp://deeplink" />
</action>
</actions>
JSON-LD sample
The following JSON-LD sample provides some example values that you can
use in the App Actions test tool:
{
"@context": "http://schema.org",
"@type": "ChargingStation",
"address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"geo": {
"@type": "GeoCoordinates",
"latitude": "37.3861",
"longitude": "-122.084"
},
"name": "Googleplex"
}