Places API Reference

{Object} params

An object containing the following request parameters:

• placeId {String} - id of a place (from nokia.places.objects.Place), required
• onComplete {Function} - a function to be called when the request has been completed, required; the function must accept as arguments responseData and status described under Returns below
• start {Number} - the starting offset for results, optional
• limit {Number} - maximum number of results to be returned, optional

The return value is made available asynchronously as an argument passed to the onComplete handler and it is a list (nokia.places.objects.List) of elements of the type nokia.places.objects.Media; onComplete's second argument is status, a {String} constant with the value of 'ok' to indicate success or 'error' to indicate request failure or time-out

{Object} params

An object containing request parameters:

• placeId {String} - the id of a place (from nokia.places.objects.Place), required
• onComplete {Function} - a function to be called when the request has been completed, required; the function must accept as arguments responseData, which is a place object nokia.places.objects.Place containing data returned by the Places back-end, and status, which is a {String} constant with the value of 'ok' to indicate success or 'error' to indicate request failure or time-out
• basicInfo {Boolean} - a flag, if set to true only place core data are returned, otherwise all available data are returned, optional

The return value is made available asynchronously as an argument passed to the onComplete handler and it is a place object nokia.places.objects.Place; note that onComplete also receives a second argument indicating the status of the request (see also description of onComplete under getPlaceData() Parameters above)

{Object} params

An object containing request parameters:

• placeId {String} - id of a place (from nokia.places.objects.Place), required
• onComplete {Function} - a function to be called when the request has been completed, required; the function must accept two arguments responseData and status described under Returns below

The return value is made available asynchronously as an argument passed to the onComplete handler and it is a rating object, for example, {value:4,count: 120} (see also nokia.places.objects.Review); onComplete also receives a second argument, status, which is a {String} constant with the value of 'ok' to indicate success or 'error' to indicate request failure or time-out

{Object} params

An object containing the following parameters:

• placeId {String} - id of a place (from nokia.places.objects.Place), required
• onComplete {Function} - a function to be called when the request has been completed, required; the function must accept as arguments responseData and status described under Returns below
• start {Number} - optional result start offset
• limit {Number} - optional limit of returned results

The return value is made available asynchronously as an argument passed to the onComplete handler and it is a list (nokia.places.objects.List) of elements of the type nokia.places.objects.Review; onComplete also receives a second argument, status, which is a {String} constant with the value of 'ok' to indicate success or 'error' to indicate request failure or time-out

{Object} params

An object containing the following parameters:

• placeId {String} - id of a place (from nokia.places.objects.Place), required
• ratingValue {Number} - a rating value, required
• onComplete {Function} - a function to be called when the request has been completed, required; the function must accept as arguments responseData and status described under Returns below

The return value is made available asynchronously as an argument passed to the onComplete handler and it is a rating object containing the calculated rating for a place, for example, {value:4,count: 120} (see also nokia.places.objects.Review); onComplete also receives a second argument, status, which is a {String} constant with the value of 'ok' to indicate success or 'error' to indicate request failure or time-out