The action media type describes a user interaction made against the Places (Search) API, for example, the user clicking to the dial the phone number of a place.

Media Type URI

urn:nlp-types:action-post
Attribute Type Description
meta Object[Meta]; optional Meta information about the operation to report actions.
actions Array[Action] The actions that are being reported.

Meta Object

This object contains meta-information describing the upload of action information that is taking place. The meta object object has the following attributes:

Attribute Type Description
currentTimestamp String[DateTime]; optional The time that the upload to the Actions resource was made, according to the clock from which the actions' timestamp field values came from.

Action Object

The action object represents an interaction made against a place. It has the following attributes:

Example

{
	"actions": [
		{
			"resource": "http://places.ls.hereapi.com/places/v1/places/276u33db-5e332e9253f94042a3f086a2c19ea4bb;context=Zmxvdy1pZD1kNTQwYzMzZC1kYmI1LTU2NDQtYmI5Yi1jZDZlZjY4NWY4NmJfMTQwOTMwMTcyMzc2N18wXzUxMjEmcmFuaz0w?apiKey={YOUR_API_KEY}",
			"types": [
				"urn:nlp-actions:placeselected",
				"urn:nlp-actions:viewplaceonmap"
			],
			"timestamp": "2013-07-12T14:34:10.763+0100"
		},
        {
            "resource": "http://places.ls.hereapi.com/places/v1/places/276u33db-2c192376ea8541419d3e26bc4aa4f7f9;context=Zmxvdy1pZD1kNTQwYzMzZC1kYmI1LTU2NDQtYmI5Yi1jZDZlZjY4NWY4NmJfMTQwOTMwMTcyMzc2N18wXzUxMjEmcmFuaz0x?apiKey={YOUR_API_KEY}",
            "types": [
                "urn:nlp-actions:placeselected",
                "urn:nlp-actions:drivingdirections"
            ],
            "timestamp": "2013-07-12T14:38:10.763+0100"
        }
	]
}

Action Type URNs

The following is a list of action type URNs that we suggest to use for some of the actions that we expect to be made with Places (Search) API places. This list is not intended to be exhaustive.