Places (Search) API Developer's Guide

Review Media Type

The review media type represents a review of a place.

Media Type URI

urn:nlp-types:review

Attribute	Type	Description
reviewId	String	An identifier for the review
date	String (RFC 3339 date-time); optional	The date the review was uploaded.
title	String; optional	The review's title
rating	Number; optional	A rating for the place, on a scale of 1 to 5.
description	String (formatted text)	The review itself.
user	Object[User]; optional	The user who made the review
language	String (RFC 5646 language tag); optional	The language of the review
via	Object[Link]; optional
supplier	Object[Link]; optional
attribution	String (formatted text); optional

GET Example

To retrieve a review, a client application can use the GET method. Here is an example for how to use GET with the review media type:

GET /places/v1/places/{placeId}/media/reviews/{reviewId}

See below for a sample of a JSON response for the GET method:

{
  "reviewId": "ugc-c425eb5b-3a69-4f45-8e2f-61ebd571fb1d",
  "date": "2013-05-08T03:13:12Z",
  "rating": 2,
  "description": "My review",
  "user": {
    "id": "05e...",
    "name": "Mustermann",
    "href": "https://...",
    "icon": "https://...",
    "type": "text/html"
  },
  "language": "en",
  "supplier": {
    "id": "here",
    "title": "HERE",
    "href": "http://...",
    "type": "urn:nlp-types:supplier",
    "icon": "http://..."
  },
  "via": {
    "href": "http://here.com/p/s-aWQ...",
    "type": "text/html"
  },
  "attribution": "Provided by <a href=\"https://here.com/profile/users/05e...\">Mustermann</a> via <a href=\"http://here.com/p/s-aWQ...\">HERE</a>"
}