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
report Object[Link]; optional A link for getting options for reporting a review because, for example, it contains inappropriate content. The response will have the report-options media type.
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>",
  "report": {
    "title": "Report this review",
    "href": "http://...",
    "type": "urn:nlp-types:report-options"
  }
}