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

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.