Maps
Applications can launch the Map application with a display showing the results of any query string constructed by using Google Maps Parameters. You can optionally select the map type (satellite or map), traffic overlay, and zoom level. Use this for mapping to a specific location, the results of a local or business search, and even driving directions.
Objects
This section describes the following object:
- params
params
Attribute | Type | Description |
---|---|---|
JSON | location |
Optional (lat, lng, acc, age). If specified, Map searches for "query" around this location. Abbreviations are:
|
layer | string | Optional. Activates selective overlays, currently limited to "t" for traffic or null for no overlay. |
query | string | Optional. Well-formed expression complying with the Google Map Parameters specification. The options include at least address, lat/lon, location and business search, or driving directions. |
type | string | Optional. Sets the display type, currently limited to "m" for map (default) and "k" for satellite. |
zoom | string |
Optional. The zoom level value is 1-18, with 18 being the maximum zoom in. Note: The maximum zoom level depends on the region. For some regions, zoom level 18 may not be available. |
Methods
This section describes the following methods:
- open
- launch
open
Launches the Maps application with an encoded URI that either conforms to the Google Map Parameters specification or maps a location or directions to a location when supplied with the appropriate target string.
Required parameter:
- target, or id plus params
Parameters
Parameter | Type | Description |
---|---|---|
target | string |
URL matching the regular expression: (.+.)?google.(com|[a-z]{2}|com?.[a-z]{2})(/maps/m|/maps/m/.*) Or, the target string can be of the form "mapto:location", where location is a well-formed location. |
params |
object |
See the params objects. |
Return Handling
There are no attributes for return handling.
Example using target
this.controller.serviceRequest("palm://com.palm.applicationManager", { method:"open", parameters:{target: "mapto: 950 Maude Ave., 94085"} });
Example using id plus params
this.controller.serviceRequest("palm://com.palm.applicationManager", { method:"open", parameters:{ id: "com.palm.app.maps", params: { query: "http://maps.google.com?q=Portland,+OR", type: "k", zoom: "16", layer: "t" } } });
launch
Launches the Maps application with a JSON object that includes queries and options for zoom, map type, and layers.
Required parameters:
- id
- params
Parameters
Parameter | Type | Description |
---|---|---|
id | string | Set to "com.palm.app.maps". |
params | object | See the params objects. |
Return Handling
There are no attributes for return handling.
Example
this.controller.serviceRequest("palm://com.palm.applicationManager", { method:"launch", parameters: { id: "com.palm.app.maps", params: { query: "palm, sunnyvale" } } });
Examples
Open Command
var theParams = { query: "Sunnyvale, CA", }; this.controller.serviceRequest("palm://com.palm.applicationManager", { method:"open", parameters: { id: "com.palm.app.maps", params: theParams } });
Launch Command
var theParams = { id:"com.palm.app.maps", params: {mapto: "Sunnyvale, CA"} }; this.controller.serviceRequest('palm://com.palm.applicationManager', { method: "launch", parameters: theParams });
Search for Pizza Around a Specified Location (lat, lng)
this.controller.serviceRequest("palm://com.palm.applicationManager", { method: "open", parameters: { id: "com.palm.app.maps", params: { location: {lat: 37.759568992305134, lng: -122.39842414855957, acc: 30}, query: "Pizza" } } });
Sample Code
See Services Sample.