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.
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"
  }
}