Places (Search) API Developer's Guide

Image Media Type

The image media type represents an image of a place.

Media Type URI

urn:nlp-types:image

Media Type Structure

The image media media type has the following attributes:

Attribute Type Description
src String (URI) A URL to the actual image
imageId String Identifier of image if uploaded via Places (Search) API (this ID is returned from an image upload response)
date String (RFC 3339 date-time); optional The date the image was uploaded.
dimensions Object(map of String to String); optional A map containing links to the sized variants of the original image.
user Object[User]; optional Details of the user who contributed the image.
report Object[Link]; optional A link for getting options for reporting an image 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

GET /places/v1/places/{placeId}/media/images/{imageId}
{
  "src": "http://...",
  "via": {
    "href": "http://...",
    "type": "text/html"
  },
  "dimensions": {
    "w32-h32": "http://...",
    "w64-h164": "http://..."
  },
  "supplier": {
    "title": "Qype",
    "href": "http://...",
    "type": "urn:nlp-types:supplier",
    "icon": "http://..."
  },
  "attribution": "Vom Qype"
}

Example POST Response

Below is an example image object, obtained from a URL in the following form:
POST /places/v1/places/{placeId}/media/images
Sample body for 201 - CREATED response status code:
{
  "src": "http://...",
  "imageId": "ugc-4e5a8b9e-e50b-4a0d-bdae-eae278293887",
  "supplier": {
    "id": "here",
    "title": "HERE member",
    "href": "http://...",
    "type": "urn:nlp-types:supplier",
    "icon": "http://..."
  },
  "attribution": "Provided by HERE member",
  "user": {
    "name": "anonymous"
  },
  "delete": {
    "title": "Delete an image",
    "href": "http://...",
    "method": "DELETE"
  }
}