{"_id":"5845a4aa9f6fbb1b00430829","version":{"_id":"5845a4a89f6fbb1b004307b7","project":"54d3007669578e0d002730c9","__v":2,"createdAt":"2016-12-05T17:32:24.708Z","releaseDate":"2016-12-05T17:32:24.708Z","categories":["5845a4a89f6fbb1b004307b8","5845a4a89f6fbb1b004307b9","5845a4a89f6fbb1b004307ba","5845a4a89f6fbb1b004307bb","5845a4a89f6fbb1b004307bc","5845a4a89f6fbb1b004307bd","5845a4a89f6fbb1b004307be","5845a4a89f6fbb1b004307bf","5845a4a89f6fbb1b004307c0","592deb23644f060f008e5aa6"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"25.0.0","version":"25"},"category":{"_id":"5845a4a89f6fbb1b004307be","project":"54d3007669578e0d002730c9","__v":0,"version":"5845a4a89f6fbb1b004307b7","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-30T07:08:52.789Z","from_sync":false,"order":6,"slug":"domains","title":"Domains (Deprecated)"},"user":"55bafe141b0d663700781682","__v":0,"parentDoc":null,"project":"54d3007669578e0d002730c9","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-04T09:14:46.014Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":true,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":15,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Domains are being deprecated\",\n  \"body\": \"Domains are being deprecated. If you're currently using domains, please consider using our new [Prebuilt Agents](https://docs.api.ai/docs/prebuilt-agents).\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"This domain is supported in the following languages:\\n* English\\n* Italian\\n* Japanese\\n* Portuguese\\n* Russian\\n* Spanish\"\n}\n[/block]\n* [Maps: Simple Search](#maps-simple-search)\n* [Maps: Navigation](#maps-navigation)\n* [Maps: Directions](#maps-directions)\n* [Maps: Places](#maps-places)\n* [Maps: Traffic](#maps-traffic)\n* [Maps: Shortcuts](#maps-shortcuts)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Maps: Simple Search\"\n}\n[/block]\n## Maps: Search\n\n### Action\n\nName| Description  \n---|---  \nmaps.search| Requests to search something on a map  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nq| string| optional| Defines query to search on map| Where is Iceland? (q=Iceland)  \nservice_name| string| optional| Defines the maps service. _See the list of available values_: [Service List](#section-service-list)| Find London on google maps. (service_name=Google maps)  \n  \n## Maps: Open\n\n### Action\n\nName| Description  \n---|---  \nmaps.open| Requests to open a map without any specific search query  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nservice_name| string| optional| Defines the maps service. _See the list of available values_: [Service List](#section-service-list)| Open google map. (service_name=Google maps)  \n  \n## Maps: User\n\n### Action\n\nName| Description  \n---|---  \nmaps.user| Requests to find current user location on a map  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nlocation| string| optional| Specifies that location is requested. Available values: _true_| Where am I? (location=true)  \naddress| string| optional| Specifies that address is requested. Available values: _true_| What's my current address? (address=true)  \nservice_name| string| optional| Defines the maps service. _See the list of available values_: [Service List](#section-service-list)| Find me on google maps. (service_name=Google maps)  \n  \n## Maps: Service\n\n### Action\n\nName| Description  \n---|---  \nmaps.service| Requests to change default map service  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nservice_name| string| optional| Defines maps service to be used by default: See the list of available values: [Service List](#section-service-list) | Use google maps. (service_name=Google maps)  \nuse| string| optional| Defines the intent to use or not to use the service. Can be_ true_ or _false._  If not set, user did not specify what service to use.| Use google maps. (use=true) <br> Do not use google maps. (use=false)  \n\n## Reference\n\n### Service List\n\nBaidu maps  \nBing maps  \nGoogle maps  \nNaver maps  \nYahoo maps  \nYandex maps\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Maps: Navigation\"\n}\n[/block]\n## Navigation\n\n### Action\n\nName| Description  \n---|---  \nmaps.navigation_start| Requests to start navigation  \nmaps.navigation_stop| Requests to stop navigation  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nto| string| optional| Defines destination| Navigate to New York. (to=New York)  \nfrom| string| optional| Defines starting point| Navigate from New York. (from=New York)  \nsort| string| optional| Specifies sort order (in case of searching navigation to venues) Avaliable values: *nearest*, *best*| Navigate to the nearest pub. (sort=nearest)  \nroad_type| string| optional| Requests to reroute or create directions avoiding toll roads or traffic. Available values: *free_way*, *light_traffic*| Navigate me to New York avoiding toll roads (road_type=free_way) <br> Navigate me to New York avoiding traffic (road_type=light_traffic)  \nroute_type| string| optional| Requests to reroute or create directions using fastest or shortest route. Available values: *fastest*, *shortest*| Navigate me to London using the fastest way (route_type=fastest) <br> Navigate me to London using the shortest way (route_type=shortest)  \nservice_name| string| optional| Defines service to be used for current request. Available values: _Waze_, _Google navigation_| Navigate to New York using Waze (service_name=Waze)  \n\n## Navigation: Service\n\n### Action\n\nName| Description  \n---|---  \nmaps.navigation_service| Requests to change default navigation service  \n  \n### Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nservice_name| string| optional| Defines maps service to be used by default. Available values: _Garmin_, _Google navigation, Tomtom, Waze_| Use waze (service_name=Waze)  \nuse| boolean| optional| Defines the intent to use or not to use the service. Can be_ true_ or _false._  If not set, user did not specify what service to use.| Use google navigation (use=true) <br> Do not use google navigation (use=false) <br> Use some other service for navigation ()\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Maps: Directions\"\n}\n[/block]\n## Action\n\nName| Description  \n---|---  \nmaps.directions| Requests to get directions  \n  \n## Data\n\nName| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---  \nto| string| optional| Defines destination| Directions to New York (to=New York)  \nfrom| string| optional| Defines starting point| Directions from New York (from=New York)  \nsort| string| optional| Specifies sort order (in case of searching directions to venues) Avaliable values:_ nearest_, _best_| Directions to the nearest pub. (sort=nearest)  \nservice_name| string| optional| Defines service to be used for current request. Available values: _Waze_, _Google navigation_| Show directions to New York using Waze (service_name=Waze)  \nroute_type| string| optional| Requests to reroute or create directions using fastest or shortest route. Available values: _fastest_, _shortest_| Show me the shortest route to London (route_type=shortest) <br> Show me the fastest way to London (route_type=fastest)  \nroad_type| string| optional| Requests to reroute or create directions avoiding toll roads or traffic. Available values: *free_way*, *light_traffic*| Directions to New York avoiding toll roads (road_type=free_way)  \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Maps: Places\"\n}\n[/block]\n## Maps: Places: Search\n\n### Action\n\nName| Description  \n---|---  \nmaps.places| Requests to search for different types of venues  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nrequest_type| _data_| string| required| Defines the type of request: _search_, _address_, _postalcode_, _phone_| Address of the nearest cafe (request_type=address) <br> Find hotel nearby (request_type=search)  \nvenue_type| _data_| string| optional| Defines the type of requested venue.| Find a restaurant (venue_type=restaurant)  \nvenue_title| _data_| string| optional| Defines the title of the venue.| Find Seven Glaciers restaurant (venue_title=Seven Glaciers)  \nvenue_chain| _data_| string| optional| Defines the chain of the venue.| Find FamilyMart (venue_chain=FamilyMart)  \nlocation| _data_| string| optional| Defines the location.| Find a restaurant in new york (location=new york)  \nsort| _data_| list| optional| Specifies sort order: _nearest_, _best_, _cheapest_| Find a restaurant nearby (sort=[nearest]) <br> Find a good restaurant (sort=[best]) <br> Find the cheapest supermarket nearby (sort=[nearest, cheapest])  \nstars| _data_| digit| optional| Defines the class of the venue: _1_, _2_, _3_, _4_, _5_| Find 3 stars restaurant (stars=3) Find 5 star hotel (stars=5)  \ncuisine| _data_| string| optional| Defines the cuisine serving at the venue.| Find restaurant serving italian cuisine (cuisine=italian) <br> Find french restaurant (cuisine=french)  \ndish| _data_| string| optional| Defines the requested dish.| Find the place where I can eat hamburger (dish=hamburger)  \nmeal| _data_| string| optional| Defines the requested meal (only for restaurants). _See the list of available values:_ [Meal List](#section-meal-list)| Find a place to grab a snack (meal=snack) <br> Where I can have my breakfast (meal=breakfast)  \nbeverage| _data_| string| optional| Defines the beverage.| I want to drink coffee (beverage=coffee)  \nvenue_facility| _data_| list| optional| Defines the list of requested venue facilities. _See the list of available values:_ [Venue Facility List](#section-venue-facility-list)| Find a cafe with free wi-fi (venue_facility=[wifi]) <br> I need a hotel with free wi-fi and parking place (venue_facility=[parking, wifi])  \nroom_facility| _data_| list| optional| Defines the list of requested room facilities (only for hotels). _See the list of available values:_ [Room Facility List](#section-room-facility-list)| Find a hotel room equipped with air conditioner (room_facility=[air conditioning]) <br> I search for a hotel room with terrace and good view (room_facility=[terrace, good view])  \nboard_type| _data_| string| optional| Defines the requested board type. _See the list of available values:_ [Board Type List](#section-board-type-list)| Find all inclusive resorts (board_type=AI) <br> Find a hotel offering breakfast and dinners only (board_type=HB)  \nservice_name |  _data_| string| optional| Specifies the service to be used for current request. _See the list of available values:_ [Service List](#section-places-service-list)| Find a restaurant on Google Places (service_name=google places)  \n  \n## Maps: Places: Service\n\n### Action\n\nName| Description  \n---|---  \nmaps.places_service| Requests to change default places service  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \nservice_name| _data_| string| optional| Defines the service to be used by default. _See the list of available values:_ [Service List](#section-places-service-list)| Use Google Places (service_name=google places)  \nuse| _data_| string| optional| Defines the intent of use or not to use the service. Can be _true_ or _false_. If not set, user did not specify what service to use.| Use Google Places (use=true) <br> Do not use Google Places (use=false)  \n  \n## Reference\n\n### Meal List\n\nbreakfast  \nbreakfast &amp; brunch  \nbrunch  \ndinner  \nlunch  \nsnack\n\n### Venue Facility List\n\nbeauty salon  \ndisabled friendly  \nfitness center  \ninternet  \nkids friendly  \nkitchen  \nlaundry  \nnon-smoking  \nparking  \npet friendly  \npool  \nsmoking  \nspa  \ntransfer  \nwifi\n\n### Room Facility List\n\nair conditioning  \ngood view  \nhair dryer  \nspa tub  \nterrace  \nTV  \nwashing machine\n\n### Board Type List\n\nRO (_room only_)  \nSC (_self catering_)  \nBB (_bed and breakfast_)  \nHB (_half board_)  \nFB (_full board_)  \nAI (_all inclusive_)\n\n### Places Service List\n\ngoogle places\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Maps: Traffic\"\n}\n[/block]\n## Action\n\nName| Description  \n---|---  \nmaps.traffic| Requests for traffic information  \n  \n## Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \ntraffic_event| _data_| string| optional| Defines requested traffic event. Available values: *accidents*, *roadworks*, *speedcameras*, *traffic_jams*| Any accidents nearby? (traffic_event=accidents)  \nlocation| _data_| string| optional| Defines the location.| Is there traffic on Main street? (location=Main street)  \nlocation_between| _data_| list of objects| optional| Defines the traffic between two locations.| What's the traffic between London and Bristol? (location_between=[\\{location=London\\},\\{location=Bristol\\}])  \ncurrent_location| _data_| string| optional| Specifies that current location is requested. Available values: _true_ | Any accidents nearby? (current_location=true)  \nen_route| _data_| string| optional| Specifies that traffic along the route is requested. Available values: _true_  | Is there traffic on my way? (en_route=true)  \ninfo| _data_| string| optional| Defines the requests for traffic information. Available values: _length_, _time_| How long is this traffic jam? (info=length)  \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Maps: Shortcuts\"\n}\n[/block]\n## Shortcuts: Save\n\n### Action\n\nName| Description  \n---|---  \nmaps.shortcuts_save| Requests to save maps shortcuts  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \ntype| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| Save my home address. (type=home)  \naddress| _data_| string| optional| Defines the address of the shortcut.  Can be _current_ if the user wants to create a shortcut for the current location.| I live at 7475 Franklin Ave, Los Angeles. (address=7475 Franklin Ave, Los Angeles) <br> I work here (address=current)  \n  \n## Shortcuts: Change\n\n### Action\n\nName| Description  \n---|---  \nmaps.shortcuts_change| Requests to change saved shortcuts  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \ntype| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| Change my home address. (type=home)  \n  \n## Shortcuts: Get\n\n### Action\n\nName| Description  \n---|---  \nmaps.shortcuts_get| Requests to get saved shortcuts  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \ntype| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| What's my home address? (type=home)  \n  \n## Shortcuts: Remove\n\n### Action\n\nName| Description  \n---|---  \nmaps.shortcuts_remove| Requests to remove saved shortcuts  \n  \n### Data\n\nName| Parent| Data type| Required / Optional| Description| Request examples  \n---|---|---|---|---|---  \ntype| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| Remove my home address. (type=home)","excerpt":"","slug":"maps-and-points-of-interest","type":"basic","title":"Maps and Points of Interest"}

Maps and Points of Interest


[block:callout] { "type": "warning", "title": "Domains are being deprecated", "body": "Domains are being deprecated. If you're currently using domains, please consider using our new [Prebuilt Agents](https://docs.api.ai/docs/prebuilt-agents)." } [/block] [block:callout] { "type": "info", "body": "This domain is supported in the following languages:\n* English\n* Italian\n* Japanese\n* Portuguese\n* Russian\n* Spanish" } [/block] * [Maps: Simple Search](#maps-simple-search) * [Maps: Navigation](#maps-navigation) * [Maps: Directions](#maps-directions) * [Maps: Places](#maps-places) * [Maps: Traffic](#maps-traffic) * [Maps: Shortcuts](#maps-shortcuts) [block:api-header] { "type": "basic", "title": "Maps: Simple Search" } [/block] ## Maps: Search ### Action Name| Description ---|--- maps.search| Requests to search something on a map ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- q| string| optional| Defines query to search on map| Where is Iceland? (q=Iceland) service_name| string| optional| Defines the maps service. _See the list of available values_: [Service List](#section-service-list)| Find London on google maps. (service_name=Google maps) ## Maps: Open ### Action Name| Description ---|--- maps.open| Requests to open a map without any specific search query ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- service_name| string| optional| Defines the maps service. _See the list of available values_: [Service List](#section-service-list)| Open google map. (service_name=Google maps) ## Maps: User ### Action Name| Description ---|--- maps.user| Requests to find current user location on a map ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- location| string| optional| Specifies that location is requested. Available values: _true_| Where am I? (location=true) address| string| optional| Specifies that address is requested. Available values: _true_| What's my current address? (address=true) service_name| string| optional| Defines the maps service. _See the list of available values_: [Service List](#section-service-list)| Find me on google maps. (service_name=Google maps) ## Maps: Service ### Action Name| Description ---|--- maps.service| Requests to change default map service ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- service_name| string| optional| Defines maps service to be used by default: See the list of available values: [Service List](#section-service-list) | Use google maps. (service_name=Google maps) use| string| optional| Defines the intent to use or not to use the service. Can be_ true_ or _false._  If not set, user did not specify what service to use.| Use google maps. (use=true) <br> Do not use google maps. (use=false) ## Reference ### Service List Baidu maps Bing maps Google maps Naver maps Yahoo maps Yandex maps [block:api-header] { "type": "basic", "title": "Maps: Navigation" } [/block] ## Navigation ### Action Name| Description ---|--- maps.navigation_start| Requests to start navigation maps.navigation_stop| Requests to stop navigation ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- to| string| optional| Defines destination| Navigate to New York. (to=New York) from| string| optional| Defines starting point| Navigate from New York. (from=New York) sort| string| optional| Specifies sort order (in case of searching navigation to venues) Avaliable values: *nearest*, *best*| Navigate to the nearest pub. (sort=nearest) road_type| string| optional| Requests to reroute or create directions avoiding toll roads or traffic. Available values: *free_way*, *light_traffic*| Navigate me to New York avoiding toll roads (road_type=free_way) <br> Navigate me to New York avoiding traffic (road_type=light_traffic) route_type| string| optional| Requests to reroute or create directions using fastest or shortest route. Available values: *fastest*, *shortest*| Navigate me to London using the fastest way (route_type=fastest) <br> Navigate me to London using the shortest way (route_type=shortest) service_name| string| optional| Defines service to be used for current request. Available values: _Waze_, _Google navigation_| Navigate to New York using Waze (service_name=Waze) ## Navigation: Service ### Action Name| Description ---|--- maps.navigation_service| Requests to change default navigation service ### Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- service_name| string| optional| Defines maps service to be used by default. Available values: _Garmin_, _Google navigation, Tomtom, Waze_| Use waze (service_name=Waze) use| boolean| optional| Defines the intent to use or not to use the service. Can be_ true_ or _false._  If not set, user did not specify what service to use.| Use google navigation (use=true) <br> Do not use google navigation (use=false) <br> Use some other service for navigation () [block:api-header] { "type": "basic", "title": "Maps: Directions" } [/block] ## Action Name| Description ---|--- maps.directions| Requests to get directions ## Data Name| Data type| Required / Optional| Description| Request examples ---|---|---|---|--- to| string| optional| Defines destination| Directions to New York (to=New York) from| string| optional| Defines starting point| Directions from New York (from=New York) sort| string| optional| Specifies sort order (in case of searching directions to venues) Avaliable values:_ nearest_, _best_| Directions to the nearest pub. (sort=nearest) service_name| string| optional| Defines service to be used for current request. Available values: _Waze_, _Google navigation_| Show directions to New York using Waze (service_name=Waze) route_type| string| optional| Requests to reroute or create directions using fastest or shortest route. Available values: _fastest_, _shortest_| Show me the shortest route to London (route_type=shortest) <br> Show me the fastest way to London (route_type=fastest) road_type| string| optional| Requests to reroute or create directions avoiding toll roads or traffic. Available values: *free_way*, *light_traffic*| Directions to New York avoiding toll roads (road_type=free_way) [block:api-header] { "type": "basic", "title": "Maps: Places" } [/block] ## Maps: Places: Search ### Action Name| Description ---|--- maps.places| Requests to search for different types of venues ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- request_type| _data_| string| required| Defines the type of request: _search_, _address_, _postalcode_, _phone_| Address of the nearest cafe (request_type=address) <br> Find hotel nearby (request_type=search) venue_type| _data_| string| optional| Defines the type of requested venue.| Find a restaurant (venue_type=restaurant) venue_title| _data_| string| optional| Defines the title of the venue.| Find Seven Glaciers restaurant (venue_title=Seven Glaciers) venue_chain| _data_| string| optional| Defines the chain of the venue.| Find FamilyMart (venue_chain=FamilyMart) location| _data_| string| optional| Defines the location.| Find a restaurant in new york (location=new york) sort| _data_| list| optional| Specifies sort order: _nearest_, _best_, _cheapest_| Find a restaurant nearby (sort=[nearest]) <br> Find a good restaurant (sort=[best]) <br> Find the cheapest supermarket nearby (sort=[nearest, cheapest]) stars| _data_| digit| optional| Defines the class of the venue: _1_, _2_, _3_, _4_, _5_| Find 3 stars restaurant (stars=3) Find 5 star hotel (stars=5) cuisine| _data_| string| optional| Defines the cuisine serving at the venue.| Find restaurant serving italian cuisine (cuisine=italian) <br> Find french restaurant (cuisine=french) dish| _data_| string| optional| Defines the requested dish.| Find the place where I can eat hamburger (dish=hamburger) meal| _data_| string| optional| Defines the requested meal (only for restaurants). _See the list of available values:_ [Meal List](#section-meal-list)| Find a place to grab a snack (meal=snack) <br> Where I can have my breakfast (meal=breakfast) beverage| _data_| string| optional| Defines the beverage.| I want to drink coffee (beverage=coffee) venue_facility| _data_| list| optional| Defines the list of requested venue facilities. _See the list of available values:_ [Venue Facility List](#section-venue-facility-list)| Find a cafe with free wi-fi (venue_facility=[wifi]) <br> I need a hotel with free wi-fi and parking place (venue_facility=[parking, wifi]) room_facility| _data_| list| optional| Defines the list of requested room facilities (only for hotels). _See the list of available values:_ [Room Facility List](#section-room-facility-list)| Find a hotel room equipped with air conditioner (room_facility=[air conditioning]) <br> I search for a hotel room with terrace and good view (room_facility=[terrace, good view]) board_type| _data_| string| optional| Defines the requested board type. _See the list of available values:_ [Board Type List](#section-board-type-list)| Find all inclusive resorts (board_type=AI) <br> Find a hotel offering breakfast and dinners only (board_type=HB) service_name | _data_| string| optional| Specifies the service to be used for current request. _See the list of available values:_ [Service List](#section-places-service-list)| Find a restaurant on Google Places (service_name=google places) ## Maps: Places: Service ### Action Name| Description ---|--- maps.places_service| Requests to change default places service ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- service_name| _data_| string| optional| Defines the service to be used by default. _See the list of available values:_ [Service List](#section-places-service-list)| Use Google Places (service_name=google places) use| _data_| string| optional| Defines the intent of use or not to use the service. Can be _true_ or _false_. If not set, user did not specify what service to use.| Use Google Places (use=true) <br> Do not use Google Places (use=false) ## Reference ### Meal List breakfast breakfast &amp; brunch brunch dinner lunch snack ### Venue Facility List beauty salon disabled friendly fitness center internet kids friendly kitchen laundry non-smoking parking pet friendly pool smoking spa transfer wifi ### Room Facility List air conditioning good view hair dryer spa tub terrace TV washing machine ### Board Type List RO (_room only_) SC (_self catering_) BB (_bed and breakfast_) HB (_half board_) FB (_full board_) AI (_all inclusive_) ### Places Service List google places [block:api-header] { "type": "basic", "title": "Maps: Traffic" } [/block] ## Action Name| Description ---|--- maps.traffic| Requests for traffic information ## Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- traffic_event| _data_| string| optional| Defines requested traffic event. Available values: *accidents*, *roadworks*, *speedcameras*, *traffic_jams*| Any accidents nearby? (traffic_event=accidents) location| _data_| string| optional| Defines the location.| Is there traffic on Main street? (location=Main street) location_between| _data_| list of objects| optional| Defines the traffic between two locations.| What's the traffic between London and Bristol? (location_between=[\{location=London\},\{location=Bristol\}]) current_location| _data_| string| optional| Specifies that current location is requested. Available values: _true_ | Any accidents nearby? (current_location=true) en_route| _data_| string| optional| Specifies that traffic along the route is requested. Available values: _true_  | Is there traffic on my way? (en_route=true) info| _data_| string| optional| Defines the requests for traffic information. Available values: _length_, _time_| How long is this traffic jam? (info=length) [block:api-header] { "type": "basic", "title": "Maps: Shortcuts" } [/block] ## Shortcuts: Save ### Action Name| Description ---|--- maps.shortcuts_save| Requests to save maps shortcuts ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- type| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| Save my home address. (type=home) address| _data_| string| optional| Defines the address of the shortcut.  Can be _current_ if the user wants to create a shortcut for the current location.| I live at 7475 Franklin Ave, Los Angeles. (address=7475 Franklin Ave, Los Angeles) <br> I work here (address=current) ## Shortcuts: Change ### Action Name| Description ---|--- maps.shortcuts_change| Requests to change saved shortcuts ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- type| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| Change my home address. (type=home) ## Shortcuts: Get ### Action Name| Description ---|--- maps.shortcuts_get| Requests to get saved shortcuts ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- type| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| What's my home address? (type=home) ## Shortcuts: Remove ### Action Name| Description ---|--- maps.shortcuts_remove| Requests to remove saved shortcuts ### Data Name| Parent| Data type| Required / Optional| Description| Request examples ---|---|---|---|---|--- type| _data_| string| required| Defines the type of a shortcut. Available values: _home_, _work_, _parking_| Remove my home address. (type=home)