Places (Search) API - Places API

Transcription

REVIEW COPY - NOT FOR DISTRIBUTION - INTERNAL ONLY
Places (Search) API
Developer's Guide
Public Version 2.43.0
This is a draft document which should only be used for review. The text and images are
rendered correctly, but the look-and-feel of the document is non-standard, because it is
not for public distribution. Only approved versions of documents which have been signedoff by an authorized user on docs.in.here.com can be distributed to external customers.
For more information contact [email protected]
REVIEW COPY - INTERNAL ONLY
Places (Search) API Developer's Guide
► Notices
Important Information
Notices
Topics:
•
Legal Notices
•
Document Information
This section contains document notices.
NOT FOR DISTRIBUTION - INTERNAL ONLY
2
► Notices
3
Legal Notices
© 2016 HERE Global B.V. and its Affiliate(s). All rights reserved.
This material, including documentation and any related computer programs, is protected by
copyright controlled by HERE. All rights are reserved. Copying, including reproducing, storing,
adapting or translating, any or all of this material requires the prior written consent of HERE. This
material also contains confidential information, which may not be disclosed to others without the
prior written consent of HERE.
Trademark Acknowledgements
HERE is trademark or registered trademark of HERE Global B.V.
Other product and company names mentioned herein may be trademarks or trade names of their
respective owners.
Disclaimer
This content is provided "as-is" and without warranties of any kind, either express or implied,
including, but not limited to, the implied warranties of merchantability, fitness for a particular
purpose, satisfactory quality and non-infringement. HERE does not warrant that the content is error
free and HERE does not warrant or make any representations regarding the quality, correctness,
accuracy, or reliability of the content. You should therefore verify any information contained in the
content before acting on it.
To the furthest extent permitted by law, under no circumstances, including without limitation the
negligence of HERE, shall HERE be liable for any damages, including, without limitation, direct, special,
indirect, punitive, consequential, exemplary and/ or incidental damages that result from the use or
application of this content, even if HERE or an authorized representative has been advised of the
possibility of such damages.
► Notices
Document Information
Product
Name:
Places (Search) API
Version:
Public Version 2.43.0
Document
Name:
ID:
[ EVALUATION COPY ]
Status:
DRAFT created by [email protected]
Date:
2016-Oct-12, 13:34 (GMT)
Digital Signature
Signatory:
Issuer-Certificate:
Serial-Number.:
Method:
4
► Contents
5
Contents
Chapter 1: Overview.............................................................................................................................. 10
What is the Places (Search) API?....................................................................................................................... 11
Why use the Places (Search) API?..................................................................................................................... 11
Places (Search) API Main Features................................................................................................................... 12
Places Search & Discovery...............................................................................................................................13
Places Information............................................................................................................................................. 15
Places Interaction...............................................................................................................................................16
Chapter 2: Quick Start........................................................................................................................ 17
Making Your First Request.................................................................................................................................. 18
Chapter 3: User Guide......................................................................................................................... 26
Acquiring Credentials............................................................................................................................................27
Constructing a Request....................................................................................................................................... 27
HERE Server Environments.............................................................................................................................. 28
Key Concepts..........................................................................................................................................................29
User Flow and Hypermedia Links................................................................................................................... 29
Utilization of Hypermedia Links..................................................................................................................... 30
Backward Compatibility.................................................................................................................................... 31
API Implementation Check List......................................................................................................................... 32
Prepare for Extensibility................................................................................................................................... 32
Client Activity Tracking..................................................................................................................................... 33
Displaying Content.............................................................................................................................................34
Disclaimer......................................................................................................................................................... 35
Source Attribution.......................................................................................................................................... 35
Sponsored Search Results............................................................................................................................ 36
Testing An App................................................................................................................................................... 36
► Contents
6
Search Engines....................................................................................................................................................36
Application Authentication.................................................................................................................................. 37
Rich Content........................................................................................................................................................... 38
Place Sharing.......................................................................................................................................................... 39
JSON Response Patterns.................................................................................................................................... 39
Location Contexts................................................................................................................................................. 40
External References.............................................................................................................................................. 44
Representation Modifiers.................................................................................................................................... 46
Page Size (size)................................................................................................................................................ 46
Text Format (tf)................................................................................................................................................ 47
Image dimensions (image_dimensions)................................................................................................... 47
Show content (show_content)..................................................................................................................... 48
Show references (show_refs)....................................................................................................................... 48
Teasers (teasers)............................................................................................................................................ 50
Category systems (cs)......................................................................................................................................50
Pagination of Collections.....................................................................................................................................50
Localization............................................................................................................................................................. 51
Cross-Domain JavaScript Requests.................................................................................................................. 54
Gzip Compression................................................................................................................................................. 54
Categories............................................................................................................................................................... 55
Examples.................................................................................................................................................................. 56
Using free-text search for whole query....................................................................................................... 56
Using Autosuggest for search as you type................................................................................................. 59
Service Support..................................................................................................................................................... 63
Chapter 4: API Reference................................................................................................................. 64
Search Results Ranking........................................................................................................................................65
HTTP Request Headers........................................................................................................................................ 65
Request Entrypoints............................................................................................................................................. 67
Search and Discovery Entrypoints................................................................................................................. 68
Autosuggest Entrypoint................................................................................................................................ 68
Search Entrypoint........................................................................................................................................... 72
► Contents
7
Voice Search Entrypoint................................................................................................................................ 76
Explore Entrypoint.......................................................................................................................................... 80
Browse Entrypoint.......................................................................................................................................... 84
Browse by Corridor Entrypoint.................................................................................................................... 88
Here Entrypoint............................................................................................................................................... 94
Around Entrypoint...........................................................................................................................................98
Suggest Entrypoint...................................................................................................................................... 103
Browse-Pt-Stops Entrypoint...................................................................................................................... 105
Two-Box-Search Entrypoint....................................................................................................................... 109
Tiles Entrypoint............................................................................................................................................. 112
Additional Entrypoints.................................................................................................................................... 115
Lookup Entrypoint........................................................................................................................................ 115
Place Categories Entrypoint...................................................................................................................... 116
Cuisine Categories Entrypoint................................................................................................................... 119
Actions Entrypoint........................................................................................................................................ 121
Corridor Shortener Entrypoint.................................................................................................................. 123
Health Entrypoint......................................................................................................................................... 126
Entrypoint maturity and availability............................................................................................................ 127
Response Resources.......................................................................................................................................... 128
Media Types...................................................................................................................................................... 128
Search Media Type....................................................................................................................................... 128
Search Description....................................................................................................................................129
Search Context Information................................................................................................................... 129
Search Location......................................................................................................................................... 130
Search Results Media Type........................................................................................................................ 131
Place Media Type.......................................................................................................................................... 133
Alternative Name....................................................................................................................................... 137
Location....................................................................................................................................................... 137
Ratings......................................................................................................................................................... 138
Extended Attributes..................................................................................................................................138
Departures Extended Attribute............................................................................................................. 143
Schedule...................................................................................................................................................... 143
Departure.................................................................................................................................................... 144
► Contents
8
DepartureTime........................................................................................................................................... 145
PTOperator................................................................................................................................................. 145
OperatorSupplier....................................................................................................................................... 146
OperatorLink.............................................................................................................................................. 146
Related Places............................................................................................................................................ 146
Media Object Structure........................................................................................................................... 147
Review Media Type.......................................................................................................................................147
Rating Media Type........................................................................................................................................149
Image Media Type........................................................................................................................................ 149
Report Options Media Type....................................................................................................................... 151
Report Post Media Type............................................................................................................................. 152
Category Media Type...................................................................................................................................152
Category Graph Media Type...................................................................................................................... 153
Category Graph Node.............................................................................................................................. 153
Supplier Media Type.................................................................................................................................... 154
Suggestions Media Type.............................................................................................................................154
Action Post Media Type.............................................................................................................................. 155
Meta Object................................................................................................................................................ 155
Action Object..............................................................................................................................................156
JSON Structure Objects and Attributes..................................................................................................... 158
Link Object Structure.................................................................................................................................. 158
Label Node.................................................................................................................................................. 159
Collection Link............................................................................................................................................160
Favourite Place Link..................................................................................................................................160
Place Link.................................................................................................................................................... 162
Reference.................................................................................................................................................... 168
Transit Lines Extended Attribute.......................................................................................................... 169
TransitLine.................................................................................................................................................. 169
TransitLineCategory................................................................................................................................. 170
TransitLineStyle......................................................................................................................................... 170
Destination..................................................................................................................................................171
AccessPoint................................................................................................................................................. 171
SideOfStreet............................................................................................................................................... 171
► Contents
9
Opening Hours........................................................................................................................................... 171
Structured Opening Hours......................................................................................................................172
Extended Attribute................................................................................................................................... 173
Phonetic Place Information.................................................................................................................... 174
Phonetic Transcription............................................................................................................................. 174
Phonetic Address...................................................................................................................................... 174
Search Link................................................................................................................................................. 175
User Object Structure................................................................................................................................. 177
Media Collection........................................................................................................................................... 177
Action Link.................................................................................................................................................. 179
PlaceEditorial.............................................................................................................................................. 179
PlaceImage.................................................................................................................................................. 180
PlaceReview................................................................................................................................................ 181
Object Structure For Paginateable Collections..................................................................................... 182
Address Object Structure........................................................................................................................... 183
Alternative Name.......................................................................................................................................... 185
Contacts Object Structure......................................................................................................................... 185
Labeled Value............................................................................................................................................. 186
Error Object Structure................................................................................................................................ 187
SubError....................................................................................................................................................... 188
Location Object Structure.......................................................................................................................... 189
Rating Object Structure.............................................................................................................................. 189
HTTP Status Codes.............................................................................................................................................189
Supported Chain and Category Query Terms.............................................................................................. 190
English (UK) Category-like Query Terms.................................................................................................... 190
French Category-like Query Terms............................................................................................................. 206
Spanish Category-like Query Terms........................................................................................................... 302
Italian Category-like Query Terms.............................................................................................................. 321
Turkish Category-like Query Terms............................................................................................................ 335
List of Supported Chain-like Query Terms............................................................................................... 344
Appendix A: Coverage Information......................................................................................372
► Overview
10
Chapter
1
Overview
Topics:
•
What is the Places (Search...
•
Why use the Places (Search...
•
Places (Search) API M...
This document describes the main features and characteristics
of the Places (Search) API component within the HERE Platform.
Specifically, it describes the entry points, main elements, critical
resources and other key aspects of the RESTful version of the
Places (Search) API.
This document is intended for API users with beginner to expert
levels of knowledge and experience with APIs . As such, the
document contains in depth descriptions of the main entrypoints
via headers, their elements, and the responses for each in the
JSON open standard. In addition, this document explores the
functions of common use cases, and exceptional or important use
cases.
For more introductory information about the Places (Search) API
component, and the HERE Platform in general, please see the HERE
Platform White Paper. For more advanced level instruction and
documentation for developers of all HERE components, please see
the resources at https://developer.here.com.
► Overview
11
What is the Places (Search) API?
HERE Places (Search) API is a web service that allows users to search and explore places in the same
way as, for example, in HERE Maps, but allowing you to retain your application-specific look and feel.
HERE Places (Search) API is designed to build interactive applications which integrate online search
functionalities for Places of Interest (POI's); offers the best way to integrate address and POI-related
search & discovery
The Places (Search) API has a number of endpoints that center around two major features:
•
•
Place discovery – search for places near your users
Place description - get detailed information about the places your users are interested in
Why use the Places (Search) API?
The HERE Places (Search) API provides a simple, future-proof way to grant your application's users
access to the latest information about tens of millions of places all over the globe.
By using the Places (Search) API, your application gains several crucial advantages, including:
•
•
•
Coverage
Reduced application complexity
Forward-compatible API contract
Reduced Application Complexity
Collecting and — even more importantly — maintaining facts about tens of millions of places, while
simultaneously attaching useful and up-to-date information from various sources to them, is a
challenging task. Without the Places (Search) API, you would have to spend an enormous amount of
your resources just to collect, validate, standardize and maintain this data.
But having the data is only one side of the story. Once you have the data, you have to match this data
against your user's more or less arbitrary queries--which is further complicated by the many possible
interpetations of those queries. By taking implicit context information into account, you then have
to find the few matches (ideally: the one) most relevant to your users in their specific application
context.
Unless your core business is being a local search engine, it is quite unlikely that you want to invest the
massive amount of resources required to build a reliable place based search and discovery feature.
► Overview
12
From the top down, the API comes with a set of features that make it very convenient for you to
ignore such concerns and embed our results in the best possible way into your application's UI.
We have already dealt with subtle yet critical questions like:
•
What is the correct way to format addresses in Finland?
•
How can I get images in sizes optimized to my UI?
•
What is the most concise textual representation of a place's opening hours?
•
What is the best graphical representation for a place on the map?
(and many others) so that you can focus your resources on the core domain of your application. .
Forward-Compatible API Contract
Because the nature of places in the real world are constantly changing, the API contract of the Places
(Search) API has been carefully crafted to reflect such fluidity. Although you will already find a huge
amount of valuable facts and information about places through the Places (Search) API, you should
consider this as just a starting point.
The API contract is designed in a way that allows us to introduce additional elements at any time,
without being forced to introduce a new version of the API contract. Even more importanly, when you
follow the guidance and best practices described in this document, your application user's will also
automatically receive access to those new features without you being forced to build and ship a new
version of your application.
For more information on this central feature, see Prepare for Extensibility on page 32.
Places (Search) API Main Features
The HERE Places (Search) API allows developers to build rich location-aware applications for places
search, discovery, information retrieval and interaction. These applications can be built for many
platforms including web and mobile. One application can support numerous use cases.
The Places (Search) API uses JSON representation and has a RESTful architecture. There are
resources representing RESTful entry points for each of the supported use cases, and responses
contain hyperlinks to related queries and place details (which are received in JSON).
For example, when a client application submits a GET request to the Places (Search) API using a
Search & Discovery entrypoint, the application receives a response that contains a list of links
to places resources (among other information). By accessing one of the linked Place resources,
the application can get detailed information about that place, including ratings, images, reviews,
editorials, and owner content (retrieved in the JSON format). This detailed place response also
► Overview
13
contains references to other related places, allowing the applications users to discover other places
relevant or related to their original search.
User Flow
In order to properly guide the user through the features of the Places (Search) API, client applications
are required to provide the following User Flow:
1.
Places Search & Discovery – users search and explore locations and places relevant to them ;
users either repeat step 1 or move to step 2
Note: For more information on the features offered in this step and which entrypoint is
appropriate for a particular use case, see Places Search and Discovery.
2.
Places Information – users view the information available for a location or place; users either go
back to step 1 or move to step 3
Note: For more information on this feature, please see Places Information
3.
Places Interaction – users access place-related data, share and contribute place specific
information; users go back to step 1
Note: For more information on this feature, please see Places Interaction
For more detail on the User Flow, including rationale and further explanation, see User Flow and
Hypermedia Links.
Places Search & Discovery
Places Search & Discovery allows users to find places or addresses. Within Places Search &
Discovery, the API has entrypoints that support a number of use cases. Client applications can select
from the following entypoints according to the needs of the application: Autosuggest, Search, Voice
Search Explore, Browse, Here and Around,
Note: These entrypoints are the start for the User Flow. Once the user has selected one of
the entrypoints, the application should guide them to Places Information on page 15 or
back to Places Search & Discovery.
Autosuggest Entrypoint - Provides as-you-type suggestions
Autosuggest represents lists of suggested search terms, instants results and refined search links
related to a given (partial) search term and location context. This entrypoint is used to help users
save time, iterate on their searches, and get the results.
As-you-type-suggestion features of Autosuggest:
•
auto-suggest - exploratory search queries
•
disambiguation - providing end-user with contextual information to refine search
► Overview
•
instant results of POI and addresses
•
follow link (href) in instant results and refine search results
•
highlighted result title text based on what the user typed in
14
Search Entrypoint - Finding places from text strings
Search Entrypoint processes complete textual queries based on the user's input to find specific
places. It answers questions of "where are there places matching this [complete search term]" for an
online search where a search term can be a POI or an address. The user's input can contain:
•
An address, complete or partial, for example, 40 Edwin Land Blvd, Cambridge, MA
02141 or MA 02141.
•
Street intersections, for example, W 145th St / Amsterdam Ave.
•
A Place of Interest (POI) business or place name, for example Eiffel Tower.
•
A combination of place name and location, for example Adlon, Berlin.
•
A category or a combination of category and location, for example Science Museum or
Science Museum, London. For a list of supported category-like query terms, see Supported
Chain and Category Query Terms on page 190.
•
A chain name or a combination of chain name and location, for example McDonald's or
McDonald's, New York.
Current restrictions of chain search:
•
Chain search only fires for exact matches to the chain search terms. There is no spell
correction, and no additional terms can be added. For example, "Mercedes" will do a chain
search but "Mercedes dealer" will not. For a list of supported chain-like query terms, see List
of Supported Chain-like Query Terms on page 344.
•
Chain search will always return 20 results or all results within a 200km radius, whichever is
smaller. This includes cases of "Chain + Location".
•
A telephone number of a POI, for example +33144112345.
•
Coordinates of a location, for example 52.50217,13.34149 or N52.50217,E13.34149.
•
A mapcode, for example US-CA 9F.69ZB.
Note: Mapcode lookup is a Beta feature.
As a supplementary feature, suggestions are presented as the user types the search query. This is
based on the input text and the location context.
The response, depending on query type, is a list of results that can include both matching places and
suggested alternative searches. The Places (Search) API generates results using machine-learningbased relevance ranking. The search engine includes logic to recognize and compensate for common
spelling errors.
► Overview
15
Voice Search Entrypoint - Finding places from text string queries based on user's voice
input
Voice Search processes text string queries based on the user's voice input to find specific places.
Explore Entrypoint - Finding interesting places in an area (either near the user or
selected by the user)
Explore Entrypoint retrieves a list of relevant nearby places for a Location Context. It answers the
question "What interesting locations are at this location?" The results presented to the user are
ordered by importance and popularity. The results can be filtered by multiple categories.
Browse Entrypoint - Finding nearby places in an area (either near the user or selected
by the user)
Browse Entrypoint retrieves a list of places sorted by distance for a Location Context. For Bounding
Box Location Context the results are sorted by distance from the centre of bounding box. The results
can be filtered by multiple categories.
Here Entrypoint - Identify what place is at a given position
Here Entrypoint answers the questions "Where am I?" and "What's right here where I am standing?"
The search results consist of a list of places with addresses that lie within the vicinity of the
search location. The results can be filtered by multiple categories. The feature is typically used by
applications that include "check-in" or "click on map to get more information" facilities.
Around Entrypoint - Overlay interesting places on an image or video
Around Entrypoint answers the question of "What can I see?" and "What direction are the main
attractions?" This feature is similar to the Explore entrypoint, but is specifically designed for
Augmented Reality applications, such as LiveSight. The results are based on proximity, popularity,
and importance. The results can be filtered by multiple categories.
Places Information
Places Information makes it possible for the user to examine additional information about places
returned by the Search and Discovery entrypoints. The user can decide to view the full details of a
place or choose or view related places.
Note: Places Information is the second step in the User Flow. Developers should move users
from Places Search & Discovery on page 13 to Places Information. Once a User is on
Places Information, developers should move them either back to Places Search & Discovery
► Overview
16
or to Places Interaction on page 16. Clicking on a related place is considered the same as
returning to step 1
It is through the Places information step that users experience HERE's richest set of information
relating to a place. Beyond the basics such as the place name, address, category and contact
information, the user can access an extensible collection of information aggregated from multiple
sources such as user reviews, images and editorial descriptions. Additionally, an information set
about a specific place may contain links to other related places. Extended information may also come
with a reference to the source of that information.
The following information about a place is always supported:
•
Base Attributes – includes name, location, categories, contacts, and a category icon
The following attributes might be included with a place. Given several different factors (for example
different suppliers of place information) , a place will have different kinds of additional attributes:
•
Extended Attributes – includes information such as opening hours, payment methods, annual
closing dates/times, and disabled access (note that this list is indicative, not complete)
•
Images – includes third-party and user-provided images; source information includes image
scaling
•
Reviews – includes user-generated reviews and source information
•
Editorial Descriptions – consists of third-party descriptions of a place, with source information
•
Related Places Nearby – lists related places that may be of interest to the user
•
Sharing URI – offers a link to the best available representation of the place on any operating
system, platform, or device
Places Interaction
Places Interaction refers to features of the Places (Search) API that allows a client application to
implement user interactivity and to connect their applications to other HERE applications. The
supported interactions include:
Note: Places Interaction is the final step in the User Flow. After reaching the Places
Interaction step, clients should redirect users to Places Search & Discovery on page 13
This step completes the flow. After this point, it is up to the application to decide when to
start the flow again.
•
Report a Place – the user can report a place in the wrong location, errors in place data, or a place
that should be removed
► Quick Start
17
Chapter
2
Quick Start
Topics:
•
Making Your First Request
Getting started with Places (Search) API is actually quite easy
and the process is explained in detail in the following section.
This section describes the necessary software and applications,
authorization codes, and a first use case to help you get started.
► Quick Start
18
Making Your First Request
Once you have application credentials, you can make your first request to the Places (Search) API.
First you need to connect to the appropriate server. As mentioned in greater detail in Testing An
App, the Places (Search) API, we provide a dedicated environment for customer integration testing
(CIT). The CIT environment is available to help you get familiar with the API and assist you during
the development of your applications. The production environment should only be accessed from
shipped applications.
Since we are working with the API for testing purposes we make requests to the CIT environment. In
order to access the CIT environment, use the URL https://places.cit.api.here.com.
Making a Request for Finding a Place using a Text String
Now, imagine you want to build an application for a smart device or browser where the application
always display a map to the user and a user can type a search term in an input field to find a specific
place. In order to build such an application, we will need a location context for the area that the user
wants to query. There are many possibilities how to provide a location context, see Best Practice on
page 42 for more detail about what location context to send. Let's assume that the user can set a
location context explicitly by clicking in that app somewhere in the middle of Manhattan, where the
geolocation is latitude 40.74917 and longitude -73.98529.
► Quick Start
19
Based on that geolocation information, we can implement our first feature with the Places (Search)
API by using the autosuggest entrypoint:
► Quick Start
20
Note: We are using the autosuggest entrypoint because it was specifically designed for
returning instant search results, exploratory search and refined search query suggestions as
user types.
https://places.cit.api.here.com/places/v1/autosuggest
?at=40.74917,-73.98529
&q=chrysler
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&tf=plain
&pretty=true
As you can see, the request URI contains a request to the CIT environment through the
autosuggest entrypoint (https://places.cit.api.here.com /places/v1/autosuggest), followed by
several query string parameters:
at
The selected geo-coordinate as latitude, longitude (in this case where the
User has clicked)
q
The plain-text search term.
app_id, app_code
The credentials required to identify the app (see Acquiring Credentials on
page 27)
tf
A flag that switches the presentation of rich text elements to plain text for
better readability
pretty
A flag to enable pretty printing (so that we can read the result better)
You can find out more about the various parameters that can be used to influence the returned
representation in Representation Modifiers. For now, we are using an example with some of the most
common parameters and headers.
Breaking Down the JSON Response
The default response representation for all Search & Discovery entrypoints, like the autosuggest
entrypoint we used above, is application/json. However if you use a web browser you will get an
HTML representation which is intended for exploring the API.
Note: If an Accept header is set in the request and it does not match */*, application/
json or xhtml+xml an HTTP 406 error response - "Not Acceptable" will be returned
When using the URL in your HTTP client or browser for the autosuggest entrypoint, you will receive
a JSON document containing a result list of places and refined search queries of this particular query.
For example, below is a list of places returned from the CIT environment as rendered by a browser:
{
"results": [
{ "Chrysler Building" },
► Quick Start
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
21
"Chrysler Camera Repair" },
"Manhattan CHRYSLER" },
"Chrysler Cleaners Inc" },
"Chrysler Stationery & Gift Inc" },
"Chrysler Tower Periodontics" },
"Major World CHRYSLER" },
"Chrysler Auto Repair" },
"Hudson CHRYSLER" },
"Teterboro CHRYSLER" },
"Riverdale CHRYSLER" },
"Major CHRYSLER DODGE Jeep" },
"Bayside CHRYSLER" },
"Star CHRYSLER" },
"Route 46 CHRYSLER" },
"Chrysler-Plymouth Authorized Sales & Service" },
"Monroe" },
"Kacey Chrysler" },
"Chrysler Rd" },
"CHRYSLER" }
]
}
As can be seen in the example above, most browsers will return expandable links for each individual
place. Once expanded, each of these links displays additional information about that particular place.
For example, if a user or application expands the information about the Chrysler Building they
will see:
{
"title": "Chrysler Building",
"highlightedTitle": "Chrysler Building",
"vicinity": "405 Lexington Ave\nNew York, NY 10017",
"position": [ 40.75185, -73.97572 ],
"category": "sights-museums",
"href": "https://...",
"type": "urn:nlp-types:place"
}
Some important fields to note for a suggested place media type response:
•
title gives the name of the place
•
highlightedTitle gives the name of the place with markups highlighting the parts of the
string that were matched.
•
vicinity describes of the location of the place; usually derived from the address of the place,
but may also contain any other description that helps a user understand where the place is
located.
•
position describes the geolocation of this particular place. This geolocation is suitable for
displaying the place's position on a map.
•
category explains the relevant category group for that place which helps describe it. All places
have a category, for example eat-drink, going-out,sights-museums, and more.
•
href a URI that links to to the resource from where you can fetch more data about that place.
For example, this can be used when the user selects that result item. In the above case, since
the Media Type is a place, the returned information is additional data about that place (such as
contacts, reviews, additional address information, and more)
•
type is a URI that describes the kind of resource (what are called Media Types in the Places
(Search) API) that will be returned by the href
► Quick Start
22
Using the Result in your Application
For now, lets concentrate on the most critical of the above fields in order to give the user the results
they desire. In order to properly use the place information sent from the server, you will need to:
First, render the entire list of items that are returned in the Autosuggest media type in the User
Interface of your application. The Autosuggest media type starts with results, and contains
items (the current list of places and refined search suggestions) as seen in the below example:
{
"results": [
{
"title": "Chrysler Building",
"highLightedTitle": "Chrysler Building",
"vicinity": "405 Lexington Ave\nNew York, NY 10017",
"position": [ 40.75185, -73.97572 ],
},
{
"title": "Chrysler Camera Repair",
"highlightedTitle": "Chrysler Camera Repair",
"vicinity": "367 W 34th St\nNew York, NY 10001-1647",
"position": [ 40.753098, -73.995239 ],
"category": "business-services",
},
...,
{
"title": "CHRYSLER",
"highlightedTitle": "CHRYSLER",
"type": "urn:nlp-types:search"
}
]
}
After you have parsed the result list, give users the capability to view information about each of the
places on the current list by:
•
rendering each result item in your application's User Interface using hightlightedTitle or
title object and vicinity object,
•
using the position of each result item for displaying place position's on a map and
•
providing a link to the href object URI which the user can select
Note: In case the user did not find searched place in autosuggest results, we recommend
you to use Search entrypoint in your application User Interface to submit complete search
term, for example on Enter key press event.
Just follow the flow
Now that your application's users have seen the suggested results. When a user has found the place,
the user (or your application) selects the href URI of the place, a JSON response is given with further
► Quick Start
23
data about that place. Each item listed in this response, just like with each individual place, contains a
URI that links you to the resource from where you fetch more information when the user selects that
result item.
So, in order to allow a user to view any of these items (and any other related items down the line)
all you should do is take the URI in the given result item and use it as the next request to the Places
(Search) API.
Depending on the type of the selected item, you will then either receive detailed information on
the selected place or another search result list for the refined search request. In this example
"CHRYSLER" with type urn:nlp-types:search is a refined chain/brand search.
For example, if you take the place information for the Chrysler Building and the user wants
more information about that place, then provide the user the option to select the href object (or
some kind of UI equivalent, like a button). Once the user makes the selection, send the entire href
URI as the next request to the Places (Search) API. The application will then receive a JSON response
like the one below:
Note: The response shown here is shortened for the sake of space. See Places Media Type
for a full example.
{
"name": "Chrysler Building",
"placeId": "840dr5ru-08bf72d1a15f41228438fb017f83a84c",
"view": "http://...",
"location": {
"position": [ 40.7517 , -73.97583 ],
"address": {
"text": "405 Lexington Ave at 42nd St New York City 10017 USA",
"house": 405,
"street": "Lexington Ave at 42nd St",
"postalCode": 10017,
"district": "Midtown Center",
"city": "New York City",
"country": "USA",
"countryCode": "USA"
}
},
"contacts": {
"phone": [
{
"value": "+12126823070",
"label": "Phone"
}
],
"website": [
{
"value": "http://en.wikipedia.org/wiki/Chrysler_Building",
"label": "Website"
}
]
},
"categories": [
"{ Going Out }",
"{ Landmark/Attraction }",
"{ Sights & Museums }",
"{ Theatre, Music & Culture }"
],
"icon": "http://download.vcdn.data.here.com/p/d/places2/icons/categories/05.icon",
► Quick Start
24
"ratings": {
"average": 4.75,
"count": 8
}
}
Now, you display the information received to the user and provide them with links to any further URIs
in the response. In turn, with those URIs in that response, provide any displayable information and
links to any available URIs. And so on.
Note: Almost every URI has a type field next to it that explains the kind of resource that will
be retrieved. These are the above referenced media types. Some non media type objects
also contain label fields that provide similar information
This hypermedia mechanism is the most fundamental design principle of the Places (Search) API. You
start a usage flow by constructing the URI of the entry point of the use case you want to provide (in
the above example, autosuggest) and then display the results to your users. Users then select a
hypermedia item they want to know more about and your application just uses the href attribute of
the selected item for the next request and then gets access to the required information.
So there's no need to know the URIs for all resources in your application's code. No need to construct
a URI with complex URI templates. Just follow the link, and we'll get you where you (and your users)
want to be.
Note: Please keep in mind, as pointed out in the User Flow, applications must guide users
through a flow of Search &Discovery, Information, and Interaction.
What's Next
As you've learned, the Places (Search) API provides you with a simple to use and consistent skeleton
for your application's user experience, yet you still have full control over the actual user interface
design.
The hypermedia approach also allows you to easily familiarize yourself with our API: just follow the
links in the responses and you'll find most of the things you can use to build your application.
There is only one detail missing before you can build your own application: request your own
credentials (see Acquiring Credentials on page 27). Your credentials can then be used on both
environments: CIT and production. The production domain is:
places.api.here.com
During development, you continue to use the CIT instance, but once you ship your application, you
must switch to production. While requests against both environments are subject to the same quota
limits, only those against production will be reflected in the application statistics that you find next
to your application's registration info. And you don't want to miss the information on how your
► Quick Start
25
application is used. Also, the quality of service in terms of availabiltiy and latency is only managed in
the production environment.
The Remainder of This Document
While you can learn a lot about the Places (Search) API by just playing with it, we still strongly
recommend you read the remainder of this document before you start implementing your
application. Your application's extensibility and maintainability will benefit dramatically when you
learn about the fundamental design patterns and apply the best practices that we outline in this
document.
Also, you may want or need to leave the regular path outlined by the hypermedia links of the system.
While your application will never have to give up the beauty of the hypermedia pattern, we provide
you with simple mechanisms to adjust the behavior of the system to your application's needs.
You'll find this information in the following chapters:
Core API Features provides an in-depth tutorial for developers that guides you through the
concepts and best practices of the Places (Search) API using several simple examples.
References includes a detailed specification of all entry points, data types and other elements
that comprise the Places (Search) API.
Additional Resources
Playground
You can browse an HTML representation of the API to get a feel for what it
provides. Just point a browser to
https://places.cit.api.here.com/places
stackoverflow
We would love to get your feedback about Places (Search) API. Please join
the conversations in the developer forum
► User Guide
26
Chapter
3
User Guide
Topics:
•
Acquiring Credentials
•
Constructing a Request
•
Key Concepts
•
API Implementation Check ...
•
Application Authentication
•
Rich Content
•
Place Sharing
•
JSON Response Patterns
•
Location Contexts
•
External References
•
Representation Modifiers
•
Pagination of Collections
•
Localization
•
Cross-Domain JavaScript Re...
•
Gzip Compression
•
Categories
•
Examples
•
Service Support
The User Guide section explains necessary ideas or requirements
for developers of Places (Search) API to understand in order to
build an application that will work properly with the Places (Search)
API. In the following section, there is an explanation of additional
authentication methods as well as a description of requirements
for client applications.
27
► User Guide
Acquiring Credentials
All users of HERE APIs must obtain authentication and authorization credentials and provide them as
values for the parameters app_id and app_code. The credentials are assigned per application.
This document uses the placeholder text {YOUR_APP_CODE} and {YOUR_APP_ID} as placeholders
for access and authorization credentials. Please replace these placeholders with your own unique
application-specific credentials to access the API resources.
To obtain the credentials for an application, please visit http://developer.here.com/plans to register
with HERE.
If you wish to explore the API, use the API Explorer at https://developer.here.com/api-explorer.
Constructing a Request
A request to the Places (Search) API, includes the basic elements shown in the following table and, in
addition, it may contain resource-specific parameters.
Element
Value/Example
Description
Base URL
https://
Production environment
places.api.here.com
https://
CIT environment: see HERE Server Environments on
places.cit.api.here.com
page 28
Path
/places/v1/
Resource
autosuggest
Get autocomplete suggestions for partial search
queries. See Autosuggest Entrypoint on page 68
discover/search
Find places using a completed text query. See
Search Entrypoint on page 72
discover/voice
Find places using a text query produced by some
voice recognition software. See Voice Search
Entrypoint on page 76
discover/explore
Find recommended places with certain categories
around a location. See Explore Entrypoint on page
80
28
► User Guide
Element
Value/Example
Description
browse
Find places with certain categories around a location
sorted by distance. See Browse Entrypoint on page
84
browse/by-corridor
Find places with certain categories within a corridor
area. See Browse by Corridor Entrypoint on page
88
browse/by-corridor/short
Simplifies route required for the corridor search.
See Corridor Shortener Entrypoint on page 123
discover/here
Identify places at a location. See Here Entrypoint on
page 94
discover/around
Find places around a location. Similar to discover/
explore, but optimized for 3D visual-exploration
overlays. See Around Entrypoint on page 98
actions
Report user interactions. See Actions Entrypoint on
page 121
lookup
Find a place by non-Place ID, e.g. PVID. See Lookup
Entrypoint on page 115
categories/places
Get place categories that are supported within a
region. See Place Categories Entrypoint on page
116
categories/cuisines
Get cuisines categories that are supported within a
region. See Cuisine Categories Entrypoint on page
119
health
Monitor the availability of the Places (Search) API
See Health Entrypoint on page 126
Application Id
?app_id={YOUR_APP_ID}
Substitute with your own unique app_id
Application Code
Substitute with your own unique app_code
HERE Server Environments
HERE provides two server environments for handling your requests: a Production environment and a
Customer Integration Testing (CIT) environment.
You are required to use the CIT Environment when evaluating our products via our 90-day free trial.
To access CIT for REST APIs, amend the base URL to include an additional cit segment. For example,
the CIT URL for this API is https://places.cit.api.here.com.
► User Guide
29
HERE examples and demos use this CIT environment only to provide an illustration of how the service
operates.
You are required to use the Production environment for general production use. The CIT environment
must not be used for production.
High Loads and Performance Testing
Neither standard server environment (CIT and Production) is designed to support high loads or
performance testing. You must not conduct performance tests against the CIT or Production
environments. If you need to do performance testing, please contact HERE to discuss options.
Key Concepts
This section provides information on key concepts used in the Places (Search) API.
User Flow and Hypermedia Links
As mentioned in Places (Search) API Main Features on page 12, the Places (Search) API entrypoints
are designed to be used in a required User Flow. For each user flow, the entrypoints specifically
described as Search & Discovery Entrypoints in the documentation are always accessed first. The
diagram below illustrates typical user flows.
Other entrypoints, the Additional Entrypoints, can be accessed only by following links returned from
these root resources and accessing these links must be triggered by a deliberate and specific user
interaction with the link. For example, it is not permissible to download all pages linked to from
a response in order to try to improve performance. Nor is it permissible to write applications (or
'robots') to access and/or analyse the content from the Places (Search) API.
► User Guide
30
More specifically, clients may use URL templating only for root resources. The hyperlinks on these
resources contain URLs to follow in order to access other endpoints in the system. Unless specifically
documented otherwise, it is not permissible to use URL templating for these other entrypoints.
This is vital because by using URI templating, a request would not include critical information that
is required to create the response for the next request. The entrypoints documented will not be
changed without clients being informed. Other entrypoint URLs may change at any time. Using the
proper workflow by following links rather than URL templating is the only way to guarantee that an
application will not create broken links.
Utilization of Hypermedia Links
Client applications interact with the Places (Search) API JSON representations using hypermedia links
in the resources.
Place
A hypermedia link is represented as a JSON object which has an href attribute. Other link attributes
may be present which give more details about the link (see the link object definition). For example, a
place resource contains links to the category resources associated with the place:
{
"name": "Max's Pizza Place",
"placeId": "360u09tv-be16478e55314b338c551aab2651c9d3",
"categories": [
{
"id": "restaurant",
"title": "Restaurant",
"href": "http://...",
"type": "urn:nlp-types:category",
"icon": "http://..."
}
]
}
Category
The link object in the categories array points to the following category resource. Notice the
attribute names are different since link objects are not resources. For example:
{
"categoryId": "restaurant",
"name": "Restaurant",
}
► User Guide
31
Method
A link object could contain a method attribute, if the action/method to be performed on the resource
is not the default retrieval GET method. For example:
{
"delete": {
"title": "Delete an item",
"href": "http://...",
"method": "DELETE"
}
}
Type of Resource
All links to Places (Search) API resources indicate the type of the resource being linked to with the
type attribute. If a client is only interested in a specific resource, it should filter links based on the
type attribute.
A link may also be to an external resource type, in which case the type attribute is either MIME media
type or missing, not a type URI. An example for this is the via link object in an image or review object:
{
"via": {
"href": "https://share.here.com/p/s-Yz1yZXN0YXVyYW5...",
"type": "text/html"
}
}
In the case that a link object doesn't contain a type attribute, clients that want to use such a link
should use the most universal http client available (usually a web browser) to open that link as it may
connect to any kind of web resource.
Places (Search) API link objects follow the convention that when a link object is an attribute value the
attribute name signifies the relation type. For example, the via attribute on a review object signifies
that the link is to the original document containing the review.
Backward Compatibility
All minor API updates and bug fixes are implemented in a way that does not break compatibility with
existing applications. Major updates that significantly change the API behavior will be released on a
different URL.
The following request interface changes are considered backward compatible:
•
•
•
Adding new endpoints.
Adding new optional parameters.
Adding new enumeration values.
► User Guide
•
•
32
Changing a parameter from mandatory to optional.
Softening a parameter constraint.
There are various areas where future releases of the Places (Search) API will silently extend the
volume and types of information provided, therefor applications should be able to handle unknown
elements and enumeration values while parsing a response (see Prepare for Extensibility on page
32).
API Implementation Check List
Client applications must honour the terms and conditions of the Places (Search) API and follow
recommended design principles and best practices as outlined in this section. The following section
highlights some specific obligations that an application's code must honour. Failure to comply with
these requirements would violate HERE Platform terms and conditions and could cause an application
to fail when the feature set is enhanced in future versions.
Prepare for Extensibility
There are various areas where future releases of the Places (Search) API will silently extend the
volume and types of information provided.
•
•
•
•
Code must check the type attribute of the hypermedia links to ensure that applications don't try
to access media types that may be introduced in future releases.
Clients should iterate over all contacts attributes of a place instead of picking specific ones to
ensure that applications can display all available contact mechanisms to users.
Developers should iterate over all extended attributes instead of picking specific ones to ensure
that applications can display all available facts about a place to users.
Developers should also iterate over all related places instead of picking specific ones to ensure
that applications can display places of all related types to users.
The API contract with client applications allows for extensibility. In general, clients can rely on the fact
that anything that is documented will remain valid at least within the major version of the API to which
the documentation applies. Anything that is not documented may change at any time.
Clients should be prepared to find new elements (content and features) in new releases of the API.
Developers are free either to ignore the new elements or – if the new elements are documented – use
them by applying generic patterns, without adverse impact on existing applications.
Developers should not be surprised to find undocumented objects, attributes, or fields in our
responses. The Places (Search) API offers feature parity to all users of the API; so even experimental
features that we initially develop with certain pilot API users will be visible from the start. But we will
► User Guide
33
only add them to the public documentation once the new feature has fully matured and proven to
add value for our users.
Please note that we may change the implementation of such features at any time, or even decide
to remove them from a future release. So unless you are fully aware of the application of these
features (and how to manage potential changes), it is best to wait to use the new features until they
are publicly documented. In other words, if a feature is not mentioned in this documentation we
recommend that you do not use it.
Client Activity Tracking
Applications using Places (Search) API must enable services to log user activities such as search
requests, search result choices and other interactions.
Activity Tracking aims to improve the future Search & Discovery experience for the user. This
feature is based on anonymously provided data about user activities such as search requests. More
specifically Places (Search) API relies on feedback from users in order to improve the statistical model
it uses for building relationships between places, ranking places and providing recommendations.
This data also helps HERE to debug customers' technical issues.
To this end, client applications should send certain tracking data with each request they make. The
data is anonymous and the purpose is not to track individual users but to improve the results from
the Places (Search) API. For detailed information for how to appropriately track client activity, see
below:
Cookies
Cookies are small pieces of data sent from services like the Places (Search) API to its clients in HTTP
response headers. The client application remembers this data, and when it later uses the same
service, it sends the cookie data back to the service. This is used to correlate different requests from
the same user.
Client applications using the Places (Search) API are required to support cookies. The Places (Search)
API uses two cookies called NLP.PS and NLP.PP, which are sent in Set_Cookie response headers.
The application should then send these cookies in Cookie request headers with each subsequent
request until the date provided in the Expires field of the cookie. If such a date is not present,
the cookie should be sent only until the end of the session. While cookie handling can be manually
implemented, most HTTP libraries have built in support for it.
If the client application sends the DNT (Do Not Track) header to the Places (Search) API, then Places
(Search) API will not use information from cookies to track user activities, but might use them for
other technical purposes.
► User Guide
34
X-Forwarded-For Header
The X-Forwarded-For header should be provided in line with the Internet Engineering Task Force
(IETF) Forwarded HTTP Extension specification.
If requests from the client application are generated on a server rather than the user's device, the
server should send the client's IP address in the X-Forwarded-For header.
User-Agent Header
The User-Agent. in header should be provided to the Places (Search) API.
Displaying Content
All results returned by the API must be shown to the user, and they must be presented to the user in
the order that they were returned by the API.
Note: Developers can use the size parameter to request a certain number of results. In
other words, if you are only interested in displaying 3 results, then set the size parameter (in
the particluar entrypoint you want to use) to 3.
However, unless otherwise stated, developers can choose which fields of these results to display to
the user and which not to show. For example, it is up to the developer whether to show a field like
averageRating.
There are several required fields to display. Currently, developers are required to display:
•
•
Source Attribution on page 35 when showing elements for which source attribution is provided
•
Full Places Data in the view URI - the UI must provide a link that allows the user of the
application to access the full place details as provided by HERE in a web browser (or any other
platform component that is capable of rendering HTML web resources). This link must use the
URI provided in the view attribute of the place.
Sponsored Search Results when they are present in the responses of search media types
As a further restriction on the display of data, the results may not be used to create 'mash-ups' or
enhanced services, if the goal is to create similar products to compete with products available from
HERE or to incorrectly attribute content from the API. Similarly, making modifications, additions,
omissions, alterations, adaptations or derivative works of the content is not allowed.
► User Guide
35
Disclaimer
Third party content
Each third party content provider is solely responsible for any content it provides, any warranties
(to the extent that such warranties have not been disclaimed), and for any claims you may have
relating to that content or your access or use of that content. HERE has no control over the third
party content or the availability or quality of such third party content, and assumes no responsibility
for material created or published even if accessed or called through a HERE service or API.
Source Attribution
The Places (Search) API gives access to content that is provided by a number of sources. Client
applications must display the source attribution next to the content. This requirement forms part of
the terms and conditions of the API.
Types of content that require attribution include images, reviews, editorials or a place itself. Below is
an example of an image object with attribution information:
{
"src": "http://...",
"via": {
"href": "http://originalArticle..",
"type": "text/html"
},
"supplier": {
"title": "Qype",
"href": "http://...",
"type": "urn:nlp-types:supplier",
},
"user": {
"name": "Max Mustermann",
"href": "http://userProfile...",
"type": "text/html",
"icon": "http://userIcon..."
},
"attribution": "Provided by <a href=\"http://originalArticle...\">Qype</a> user <a href=
\"http://userProfile...\">Max Mustermann</a>"
}
Attribution information is present in the form of link objects and as a ready-to-display HTML string
in the attribution field. The amount of attribution information will vary for different pieces
of content. Developers should refer to the reference documentation for the relevant media type
definition. For example, urn:nlp-types:supplier
► User Guide
36
For Clients Using the HTML Representation (Default)
The only step is to display the rich text in the attribution field next to the content.
For Clients Using the Plain Text Representation
If the platform does not allow display of embedded HTML, client applications will need to display the
following fields along with the content in the UI:
•
the text given in the attribution field
•
a link to the user's profile in user.href if available
•
the user's icon in user.icon if available
•
a link to the original source in via.href if available
Note: Not all of this attribution information is available for all content. However, what is
available must be displayed.
Sponsored Search Results
Result responses using the search media type may contain items in the result list marked as
sponsored. The application UI must contain a visual indication that allows users to distinguish
standard result items from sponsored results. Such an indication, for example, could be an icon,
a distinct background color, or other means of highlighting the difference between standard and
sponsored search results.
Testing An App
All testing of application must be performed against the Customer Integration Testing (CIT)
environment. Only production traffic may and has to use the production environment.
Testing to monitor the production environment is not allowed. For this purpose there is a special
health check endpoint that applications can use to test availablilty of and connectivity to our service.
X-NLP-Testing Header
The X-NLP-Testing-Header header should be provided for all test requests, i.e requests that are not
triggered by real user interaction, so that these tests do not influence the search relevance model.
Search Engines
Applications using the Places (Search) API may not be exposed in such a way that search engines can
crawl content provided by the Places (Search) API.
► User Guide
37
Application Authentication
Applications must send credentials to identify themselves to the Places (Search) API when making
requests. These credentials are a pair of values named app_id and app_code, which are obtained as
described in Acquiring Credentials on page 27. They can be sent either as query string parameters,
or using HTTP Basic Authentication.
Alternatively, enterprise and automotive applications may use OAuth 1.0 request signing to
authenticate the application, and this is required when using premium features.
Query string parameter application authentication
Applications can send the app_id and app_code as query string parameters. Note that as with all
query string parameters, the values should be URL-encoded when sent in this way. For example, the
complete URL for a search request for "Italian pizza" in Berlin might look like this:
https://places.cit.api.here.com/places/v1/discover/search?
at=52.5310%2C13.3848
&q=Italian+pizza
Note: Your application's requests will use its own unique app_id and app_code, rather the
the ones above. To obtain the credentials for an application, see Acquiring Credentials on page
27.
HTTP Basic application authentication
Instead of sending the application credentials in URL query strings, the app_id and app_code can
be sent in the Authorization header using the HTTP Basic Authentication Scheme.
The Authorization header is constructed as follows:
•
•
•
app_id and app_code are combined into a string "app_id:app_code"
The resulting string is then encoded using Base64
The Authorization method and a space, i.e. "Basic ", is then put before the encoded string.
Example of authorization header:
Header name
Header value
Authorization
Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Note: To use HTTP Basic application authentication your must send HTTPS requests.
► User Guide
38
When the application uses HTTP Basic Authentication the app_id and app_code query parameters
can be omitted.
OAuth 1.0 Request Signing
To use premium features of the Places (Search) API, applications must sign requests using their
app_id and a shared secret. OAuth 1.0 is used to sign all requests so that the client's identity can be
verified.
When using request signing, the app_id and app_code should not be sent as query string
parameters. Instead, the app_id is used as the value of oauth_consumer_key in the OAuth
signature, and the signature is signed using the application's shared secret. The app_code is not
needed at all when request signing is used.
Note: OAuth 1.0 supports authenticating both a client application and a user (or "resource
owner") to the server. The Places (Search) API only uses OAuth 1.0 for application
authentication, so there is no resource owner, and the oauth_token parameter should
therefore be omitted when following the OAuth 1.0 procedure for Making Requests.
The Places (Search) API supports the following signature methods of OAuth 1.0:
•
HMAC-SHA1
Below is an example of an authorization header that uses the HMAC-SHA1 signature method:
Authorization: OAuth realm="Example",
oauth_signature_method="HMAC-SHA1",
oauth_version="1.0",
oauth_nonce="01TKi",
oauth_timestamp="1361198411",
oauth_consumer_key="{YOUR_APP_ID}",
oauth_signature="wOJIO9A2W5mFwDgiDvZbTSMK%2FPY%3D"
•
PLAINTEXT
Note: To use the PLAINTEXT OAuth Signature Method you must send https requests.
Below is an example of an authorization header that uses the PLAINTEXT signature method
Authorization: OAuth realm="Example",
oauth_signature_method="PLAINTEXT",
oauth_version="1.0",
oauth_consumer_key="{YOUR_APP_ID}",
oauth_signature="wOJIO9A2W5mFwDgiDvZbTSMK%2FPY%3D"
Rich Content
The media section of a place details response returns different kinds of media collections, such as
editorials, reviews and images relevant for the place.
► User Guide
39
Attribution of rich content
Editorials, images and reviews come with source attribution in the attribution field. Clients that
show media content, are obliged to also show the content of the attribution field next to the media
content (for details, cf. Source Attribution).
Availability of rich content
Since some of the content comes from external providers, not all contents is available to all clients,
due to contractual reasons.
Place Sharing
The link in the place.view attribute can be used to enable users to share a place with their friends.
The link points to a human-friendly representation of the place. The link is dynamic and may return a
different representation depending on the platform on which it is being viewed. For example, if it is
being viewed from a desktop browser, it will link to the place page in HERE Maps.
The example below shows a typical view link on a place which can be used when sharing:
{
"name": "Antipodes",
"location": {
...
},
"placeId": "276u33dc-3944a4748a62499cb795cf8bee349c9c",
"view": "http://here.com/p/s-aWQ9Mjc2dTMz..."
}
JSON Response Patterns
Optional Properties
This section describes the information that is available in request responses.
If there is no value for an attribute of an object, the attribute is omitted altogether. For example, in
the review object, the id, language,and via attributes are not necessarily present:
{
"reviewId": "ugc-bdc277eb-de94-48f0-bcb8-9e53034ee0d7",
"date": "2012-03-12T17:36:56Z",
"title": "some review",
"rating": 5,
"description": "some review description",
"user": {
► User Guide
40
"name": "anonymous"
},
"language": "en",
"supplier": {
"id": "here",
"title": "HERE User",
"href": "http://...",
},
"attribution": "Provided by HERE User"
}
Check the reference documentation for each specific response object for information on which
properties are guaranteed to be present. Most objects (or their attributes) are listed as required or
optional.
Rich Text Properties
Properties that are intended to be displayed to the user contain rich text. For example, the "text"
attribute of the address object. HTML is currently provided as the default, and allows switching to
plain text for the entire response and/or selected fields. In the future there migh be more supported
formats, or more specification about the subset of HTML beings used.
Rendered Representations Of Complex Properties
Some attributes, like the address attribute of a place, have complex data structures for clients that
want to do something with this data. For clients that just want to display the information to the user,
there is a "text" attribute that can be presented directly to the user. This attribute is a rich text field.
{
"address": {
"street": "22 Rue du Grenier Saint-Lazare",
"postalCode": "75003",
"city": "Paris",
"countryCode": "FRA",
"country": "France",
"text": "22 Rue du Grenier Saint-Lazare\n75003 Paris\nFrance"
}
}
Location Contexts
The HERE Places (Search) API uses location information to provide results that are as relevant as
possible to your users. Location information is provided to the Places (Search) API in the form of
location contexts. Location context information is either explicitly provided by the user, e.g. by
clicking on a map, or is implicitly available to your application, such as the user's geoposition or the
map viewport currently displayed to the user.
41
► User Guide
All HERE entry points require you to provide at least one location context. It is strongly recommended
that you always provide all of the implicit location context information available to your application,
and to additionally provide an explicit location context when the user action that triggers a request
includes explicit location information. When the user does not explicitly indicate a location context,
e.g. by performing a search query from a free-text input element, the best results are achieved
by sending all available implicit location context and not sending any explicit location context
parameters. See Best Practice on page 42 for more detail about what location context to send.
Explicit Location Context
When the user explicitly indicates a location to your application, for example by clicking on a map
position to trigger a discovery query at that location, your application should provide an explicit
location context to the Places (Search) API using one of the following query string parameters:
Name
Availiability
Format
Description
at
Always
Position
Specifies an explicit
position as a point
in
Selected request types
Circle or Bounding Box
Specifies an explicit
or Polygon
area
When an explicit location context is provided in this way, we recommend that you also send any
applicable implicit location context information ( as described below). While the explicit location
context will take precedence, providing additional implicit context information will ensure you get the
best results possible.
Implicit Location Context
Your application will often have location information available to it that is not explicitly provided by
the user, such as the user's geolocation or a map area currently being displayed to the user. Sending
at least one type of implicit location context information is required in the absence of an explicit
location context, and you are strongly encouraged to send implicit location context information to
ensure you get optimal results even when providing an explicit location.
Applications should always send the following implicit location context headers when the values are
known:
Name
Format
Description
Geolocation
Position
Specifies the physical position of a user
X‑Map‑Viewport
Bounding Box
Specifies the map area currently
displayed to the user
► User Guide
42
As an example of a case in which you should rely on implicit location context information alone,
consider a user sitting on a train, browsing a map of their destination. Looking out of the window they
see a castle and want to learn more about it, so they use your application's search function with a
query of castle. What is the most important piece of location context information for this search
query? The user has not indicated an explicit location, and the most relevant location context could
be the user's current location obtained from the device's GPS unit, or the location currently visible on
the user's map. It is not obvious to the application which is the most relevant, and by providing all of
the relevant implicit location context information to the Places (Search) API, it can try to determine
and provide the most appropriate results.
Best Practice
To get the best results, applications should always send implicit location context information
when available, and only send an explicit location context parameter when the user has explicitly
indicated a specific location. Therefore, It is recommended that applications always send the XMap-Viewport header when the application is displaying a map to user, and always send the
Geolocation header when the user's position is known. This is sufficient in many use cases, and an
explicit location context (via a query string parameter) is often not required.
For example, suppose the application always displays a map to the user, and provides a textbox for
free-text search backed by the search entrypoint. If the user performs a search using this textbox,
the application should supply the X-Map-Viewport header, and if the user's position is also known,
the Geolocation header as well. The user hasn't indicated an explicit location related to their
search (other than possibly positioning the map viewport), so there is no need to specify an explicit
location context.
On the other hand, suppose the application also provides the ability to click on the map and find out
what is at that location using the Here entrypoint. In this case, the user has an explicit location by
clicking on the map, which the application should provide as an explicit location context in the at
query string parameter. The application should still send the implicit context information via the XMap-Viewport header (and the Geolocation if the user's location is available), but the explicit
location will take precedence for determining the primary location for the request.
Distance Calculation
Places in results have a distance field, which is intended to be the distance of that place from the
user or from an explicit reference point. If an explicit location context is provided the distance will be
calculated from the given position. In the absence of an explicit location context the position given in
the Geolocation header is used. If the only available location context is from the X-Map-Viewport, no
distances are returned.
► User Guide
43
Position Format
The Geolocation header (implicit context) and at parameter (explicit context) specify a position as a
'geo' URI. The position is given as comma-separated values for latitude and longitude (in the WGS 84
coordinate system), and optionally altitude (in meters above sea level), and a semicolon-separated list
of position parameters.
Applications should specify the source for the position by passing one of the following values for the
cgen parameter:
•
map for points on a map, for example, geo:53.12,10.15;cgen=map.
•
gps for values from a GPS device, for example,geo:53.12,10.15;cgen=gps.
•
sgps for shifted GPS coordinates from a device fulfilling the legal requirements in China, for
example, geo:53.12,10.15;cgen=sgps.
Uncertainty in the geo-coordinates should be given in the u parameter as the uncertainty in meters,
for example, geo:53.12,10.15;cgen=gps;u=100. This might be the uncertainty of a GPS
coordinate fix, or uncertainty resulting from the resolution of a map. An absolutely accurate position
should be specified with u=0. If the u parameter is not provided, the uncertainty is unspecified rather
than 0. For example, 39.91,116.40;cgen=gps;u=16 specifies a position derived from a GPS
device with an uncertainty of 16 meters.
Circle Format
A circular area can be specified as a location context by providing a position (as described in Position)
and an additional radius. The radius is given by setting the r parameter to the radius in meters. For
example,53.12,10.15;r=10500 specifies an area with a 10.5km radius.
Bounding Box Format
A bounding box can be used to specify a geographic area as a location context. The rectangle
spanning the area is specified in the WGS 84 coordinate system as four comma-separated values
in the following order: west longitude, south latitude, east longitude, north latitude. For example,
13.125,52.362,13.661,52.693 specifies a bounding box for Berlin.
For maps applications using HERE map tiles, the zoom level should be sent as a fifth
parameter. For example, if the zoom level is 4.3, the above example would become
13.125,52.362,13.661,52.693,4.3.
Polygon Format (Experimental)
A polygon area can be used to specify a location context by providing a
set of at least four comma-separated coordinate pairs where the first and
► User Guide
44
the last one are the same (see WGS 84 coordinate system) For example,
53.5869,10.0014,48.1305,11.5615,52.5171,13.3853,53.5869,10.0014 specifies a
polygon area of Hamburg-Munich-Berlin.
External References
The concept of external reference allows you to mash up Places (Search) API features with services
and data provided by other systems in a bidirectional way:
•
If you want to associate a place that you have found in Places (Search) API with information from
another system, Places (Search) API provides access to identifiers used by external systems.
Depending on license agreements that you might have with some external systems, you can
interact with the external systems using their identifiers.
•
If you want to interact with a place in Places (Search) API that you found in another source, you
are able to lookup the Places (Search) API place with the help of the identifier used in the external
system.
With those features we allow your application to combine multiple systems in your applications,
without spending a huge amount of resources on matching and de-duplicating of place content
coming from multiple sources.
Getting access to external identifiers
By default, external references are not exposed in the Place Media Type on page 133. To request
for certain external references, client applications have to use the Show References Representation
Modifier to tell Places (Search) API which external systems client applications want to integrate with.
For example, using Explore Entrypoint on page 80 to find hotels in San Francisco:
http://places.cit.api.here.com/places/v1/discover/explore?
at=37.7851%2C-122.4047&cat=accommodation&app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}
Places (Search) API would return place-details links and one of the links refers to Hotel Palomar:
{
"results": {
"next": "http://...",
"items": [
{
...,
"title": "Hotel Palomar",
...,
"href": "http://places.cit.api.here.com/places/v1/
places/8409q8yy-6af3c3e50bcb4f859686797b2be5773d;context=...",
},
...
]
}
► User Guide
45
}
To expose HERE Core Maps identifiers, client applications could just add representation modifier
"&show_refs=pvid" to all provided URL in the search results before they fetch the place details:
http://places.cit.api.here.com/places/v1/
places/8409q8yy-6af3c3e50bcb4f859686797b2be5773d;context=...&show_refs=pvid
The response then will contain the HERE Core Maps identifiers in the references attribute:
{
"name": "Hotel Palomar",
...,
"references": {
"pvid": {
"id": "1048649872"
}
},
...
}
Certain places might have more than one external identifiers that refer to same place. These
additional identifiers are exposed in the alternatives attribute:
{
...,
"references": {
"pvid": {
"id": "1048649872",
"alternatives": [
{
"id": "19435190"
}
]
}
},
...
}
Looking up place details by external identifiers
Client applications could find places by it's external identifiers. To retrieve place by external
identifier, please see Lookup Entrypoint on page 115.
Position of External References
Depending on the type of the external references, the references attribute might appear in
different parts of JSON response:
•
Place external references, references attribute is a direct children attribute of Place Media
Type on page 133
•
Location external references, references attribute is within the location attribute.
► User Guide
46
For example, adding building (3D) external system name in the representation modifier
"&show_refs=pvid,building", the JSON response might contain 2 references attributes:
{
...,
"references": {
"pvid": {
"id": "1048649872",
"alternatives": [
{
"id": "19435190"
}
]
}
},
...,
"location": {
"position": [ 37.78539 , -122.40535 ],
...,
"references": {
"building": {
"id": "9000000000000879904"
}
},
...
}
Places (Search) API media types allows client applications to adjust the presentation of the returned
response to suit their needs.
Applications can activate the various tailoring options by passing a series of options as additional
query string parameters to the request.
Note: Representation modifiers are resource-specific and therefore are not propagated to
links in the response which point to a different resource type. This means that applications
need to add representation modifiers to all links received in a response except for those that
link to the same resource type. For example, the URI in the next attribute.
Please refer to the sections on the individual media types for details on which representation
modifiers are supported for each type.
Page Size (size)
The option defines the page size (maximum number of items) of all paginateble collections in
the response; if not provided, each collection may define its own reasonable default. Individual
collections may define a maximum page size and then use that instead of the provided value.
For example:
► User Guide
47
•
In search results, the size option determines the maximum amount of result items to show on
each result list page (default: 20).
•
In media collections such as media.images, the maximum number of images to return (default:
5).
Text Format (tf)
Various attributes returned in responses are defined as rich text strings. With this option, clients can
define the format in which rich text attributes are exposed.
Supported values are:
•
html : (default) The rich text is rendered as an XHTML fragment using a subset of the standard
HTML elements applicable for text rendering, including a, b, br, ul, ol, li, i, p, h? or img (only
used for inline-images).
•
plain : The rich text attribute is reduced to a plain text representation.
Image dimensions (image_dimensions)
When a resource provides a URI of image resources (for example, photos of a place) applications
are able to request specific maximum sizes of those images to match their UI and bandwidth
requirements.
The format is that of a comma-separated list where each element specifies dimensions for a scaled
image by providing either the desired width, desired height, or both.
Valid elements are:
•
w\d+
•
h\d+
•
w\d+-h\d+
Examples:
•
image_dimensions=w32-h32,w64-h64
•
image_dimensions=w32-h32,w300
•
image_dimensions=h200
The provided values are used as upper boundaries for the dimensions of the returned images. The
solution will never scale up small images and will maintain the aspect ratio of the original image.
If this option is used, the image objects in media.images.items contain a dimensions attribute,
which is a map containing links to the sized variants of the original image.
48
► User Guide
For example:
{
"src": "http://...",
"dimensions": {
"w32-h32": "http://...",
"w64-h64": "http://..."
}
}
Show content (show_content)
show_content allows applications to request additional content related to the search result.
The format is a comma-separated list of content names.
Identifier
Description
wikipedia
This option can be used to show Wikipedia editorial content in
Place Media Type on page 133 response.
Note: HERE has no control over the availability and
quality of Wikipedia content. For more detail, please
read HERE Disclaimer on third party content. When
displaying Wikipedia content, client applications
must display the source attribution next to the
content. This requirement forms part of the terms
and conditions of the Places (Search) API.
fuel
The HERE platform also has a fuel service. The fuel service
has information about fuel prices and fuel types from petrol
stations. In case show_content contains fuel, Places
(Search) API will enrich search result with fuel content. This
is only done if search result has petrol-station category. This
option can only be used when requesting the Search Media
Type on page 128.
Example of fuel content:
"fuelPrices": {
"text":"Super Unleaded: EUR 1.359/l Diesel: EUR 1.089/l",
"label":"Fuel Prices"
}
Show references (show_refs)
show_refs allows applications to request place/location related ids of external systems to be
included in returned response.
49
► User Guide
The format is a comma-separated list of external system names.
The option can only be used when requesting the following media types:
•
Place Media Type on page 133
•
Search Media Type on page 128
Places (Search) API currently support the following external systems:
Name of the system
Identifier
Description
HERE Core Maps
pvid
HERE’s core content product provides
map and POI data for most regions of
the world. This data product provides
long term stable identifiers, called PVID.
For the subset of map features that
are available through Places (Search)
API, that external reference allows to
correlate information available in the
two products
HERE Venue Maps
venues.*
HERE’s venue maps product provides
indoor maps for thousands of venues. It
provides three type of identifiers:
•
venues: All types of venue IDs
•
venues.venue: Venue IDs
•
venues.content: Venue content
IDs
•
venues.destination: Venue
destination IDs
All types of identifier can be used to
associate the corresponding objects
in the venue maps product with Places
(Search) API
Facebook
facebook
Application can use Facebook unique
page ID to retrieve content directly from
Facebook Graph API
Yelp
yelp
Application can use Yelp unique ID to
retrieve content directly from Yelp
Business API
TripAdvisor
tripadvisor
Application can use TripAdvisor unique
ID to retrieve content directly from
TripAdvisor Content API
50
► User Guide
Name of the system
Identifier
Description
Opentable
opentable
Website developer can use OpenTable
restaurant unique ID to include
OpenTable reservation widget.
For more detailed information on External References, please refer to User Guide External
References on page 44
Teasers (teasers)
The maximum number of places in search results that should have teaser information (e.g image URL)
included.
The format is numeric value (default: 0).
Category systems (cs)
cs allows applications to request multiple place categories from different category systems to be
included in returned response.
The format is a comma-separated list of category system names.
The option can only be used when requesting the following media types:
•
Place Media Type on page 133
•
Search Media Type on page 128
•
places: Place categories
•
cuisines: Cuisine categories
Pagination of Collections
Large collections are paginated (set into a list of pages) using hyperlinks to point to the next and
previous page of items. Collections are wrapped in a paginator object that provides access to the
pagination status as well as the items on the current page.
Whether the available attribute is present and the amount of the items within a page depends on
the use case. For example, in the future, when searching for an airport, the search resource may give
a response where the first page only contains results within a maximum distance. In this scenario, a
► User Guide
51
request for the next "page" could return results with a larger maximum distance. In other words, the
amount of results on a page are dependent on both the amount of results and use case criteria.
An example of a paginator object:
{
"available": 26,
"next": "http://alphabet.com/page/3",
"offset": 3,
"items": ["d", "e", "f"]
}
Localization
Where possible, the Places (Search) API will attempt to present the response data in a language
specified by the Accept-Language request header.
The Accept-Language header should contain the user's language preferences according to the
HTTP 1.1 specification. These preferences are used to select the best available translation for the
resource information. The sections below describe in more detail how these preferences influence
the response.
Content
Content such as place reviews and editorials and extended attributes of a place will be returned in the
requested language if translations are available for it. If there are no translations available, the Places
(Search) API will fall back to the next best alternative given the preferences chosen.
Places (Search) API aggregates content from different sources. Depending on the availability of
translations for each content source, it may be the case that a resource contains content in different
languages. In this case, the Places (Search) API will make a selection that best satisfies the user's
request given the available content.
Place Names and Addresses
Where available, exonyms of place names and addresses are returned. For example, if a user's
preferred language is English, search results containing places in Munich would have addresses using
the names Munich, Germany instead of München, Deutschland.
If a place (for example in Munich, Germany) has an alternative name in English, the English
name would be returned as the place name and the original name would be present in the
alternativeNames attribute.
Addresses (and vicinity in search result items) are formatted according to the locality of the place.
52
► User Guide
Labels and Ready-to-Display Strings
Labels, category names and ready-to-display strings such the attribution attribute will be
translated into the requested language, if a translation is available. Otherwise the default is English.
There are currently translations for the following languages:
Language name
Accept-Language header value
Afrikaans
af-ZA
Albanian
sq-AL
Arabic
ar-SA
Azeri (Latin)
az-Latn-AZ
Basque
eu-ES
Belarusian
be-BY
Bulgarian
bg-BG
Catalan
ca-ES
Chinese (China)
zh-CN
Chinese (Taiwan)
zh-TW
Croatian
hr-HR
Czech
cs-CZ
Danish
da-DK
Dutch
nl-NL
English (British)
en-GB
English (United States)
en-US
Estonian
et-EE
Farsi
fa-IR
Filipino
tl, fil, fil-PH
Finnish
fi-FI
French
fr-FR
French (Canada)
fr-CA
Galician
gl-ES
German
de-DE
Greek
el-GR
Hausa
ha-Latn-NG
53
► User Guide
Language name
Accept-Language header value
Hebrew
he-IL
Hindi
hi-IN
Hungarian
hu-HU
Indonesian (Bahasa)
id-ID
Italian
it-IT
Japanese
ja-JP
Kazakh
kk-KZ
Korean
ko-KR
Latvian
lv-LV
Lithuanian
lt-LT
Macedonian
mk-MK
Malay (Bahasa)
ms-MY
Norwegian (Bokmål)
no, nb, nb-NO
Polish
pl-PL
Portuguese (Brazil)
pt-BR
Portuguese (Portugal)
pt-PT
Romanian
ro-RO
Russian
ru-RU
Serbian (Latin)
sr-Latn-CS
Slovak
sk-SK
Slovenian
sl-SI
Spanish (Mexico)
es-MX
Spanish (Spain)
es-ES
Swedish
sv-SE
Thai
th-TH
Turkish
tr-TR
Ukrainian
uk-UA
Uzbek (Latin)
uz-Latn-UZ
Vietnamese
vi-VN
► User Guide
54
Cross-Domain JavaScript Requests
Often, browsers prevent access to certain servers due to security restrictions. Cross-Domain
JavaScript Requests allows developers to work around security restrictions that would prevent an
application from contacting Places (Search) API directly. For example, certain location information
might not be retrievable without enabling this method. In order to allow full access to servers, the
Places (Search) API provides a mechanism to enable client-side cross-origin requests that allow
JavaScript resources to be fetched from another domain.
For details on how this mechanism operates, see Cross-Origin Resource Sharing. Places (Search) API
currently uses all headers and parameters of this mechanism.
In order to support browser platforms which do not yet implement Cross-Origin Resource Sharing,
GET requests can alternatively be made using JSONP. To use JSONP, your application simply
supplies the name of its callback function in the callback query string parameter. When making a
JSONP request, parameters that would normally be sent as HTTP headers can be passed as query
string parameters instead.
For example, to use JSONP to request German-language results with a callback named
myCallbackFunction, you could make a request like the example below:
GET https://places.cit.api.here.com/places/v1/discover/search?at=52.5044,13.3909
&q=restaurant
&pretty
&callback=myCallbackFunction
&Accept-Language=de
Note: The JSONP mechanism only works for GET requests. POST requests can only be made
using the Cross-Origin Resource Sharing mechanism discussed above.
Gzip Compression
Responses provided by the Places (Search) API can optionally be compressed in the gzip format.
Developers are strongly encouraged to make use of this option, as it can have a major positive
impact on the responsiveness and performance of the client application by significantly reducing the
response size.
Applications can request a gzip-compressed response in two ways. Applications can either set
the standard Accept-Encoding header or set the x-accept-encoding header. If x-accept-
► User Guide
55
encoding is set, it overides Accept-Encoding; the syntax and content of both variants are the
same. They both conform to the standard accept-encoding header specification as set by the IETF.
Header name
Header value
Accept-Encoding
gzip
x-accept-encoding
gzip
Note: When the response is gzip compressed, the Content-Encoding response header is
sent with a value of gzip.
Categories
The Places (Search) API maintains a large selection of categories that can be used to describe and
group places. The categories that are available do actually change over time and location, i.e. not all
categories are applicable at all places and categories will be added and removed in the future.
Place Categories
The Places (Search) API provides an entrypoint that can be queried to obtain a list of place categories
that are currently used in a given location Place Categories Entrypoint on page 116.
Therefore only a subset of the categories can be used as filters (for example with the Explore
Entrypoint on page 80). These filter categories are "fixed" and will not be removed in future
releases. At the moment, the subset is:
•
eat-drink
•
•
•
restaurant
◦
coffee-tea
◦
snacks-fast-food
◦
going-out
sights-museums
transport
•
•
•
•
•
•
•
airport
◦
accommodation
shopping
leisure-outdoor
administrative-areas-buildings
natural-geographical
petrol-station
atm-bank-exchange
► User Guide
•
•
56
toilet-rest-area
hospital-health-care-facility
Cuisine Categories
Additional to place categories, Places (Search) API also supports cuisine categories. A list cuisine
categories can be obtain from the entrypoint Cuisine Categories Entrypoint on page 119. This type
of category filter can only be applied in Explore Entrypoint on page 80 and Tiles Entrypoint on page
112
Examples
The following section contains more detailed stories about how to implement many features of the
Places (Search) API.
Using free-text search
The discover/search resource uses the HERE place search engine to analyse queries that have
been entered by users. It uses the location information as well as language information that is
provided along with the query to try to understand the user intent. Generally it tries to be precise, i.e.
return only results that are relevant to the query. Also, it tries to have good recall, i.e. return all the
relevant results for a particular query.
Finding a specific place by it's name
A very basic use case is that the user is searching for a specific place, i.e. they know that it exists
and want to find it. They might know its name and some location information. In this case the search
engine orders the result according to how well they match the query. An example would be to search
for the famous Brandenburg Gate in Berlin using a location in central Berlin:
https://places.cit.api.here.com/places/v1/discover/search
&at=52.531,13.3843
&q=Brandenburg+Gate
&pretty
Finding faraway places
The search engine can find places even if they are not close to the coordinates that were provided.
This is the case for places with name that are globally unique such as the Eiffel Tower. The following
► User Guide
57
query will return the Eiffel Tower in Paris even though the application indicates that the location
context is in Berlin:
&at=52.531,13.3843
&q=Eiffel+Tower
&pretty
The search engine also analyses the query for references to geographic names. So even though
there are many museums in and around Berlin the following query will return the Science Museum in
London, because London is mentioned in the query.
&at=52.531,13.3843
&q=science+museum%2C+london
&pretty
Finding a place using its address
A common way to describe locations of places are addresses. The discover/search endpoint
can also find addresses that are given as free-text user input. Even though we are providing the
Berlin location the following address search will return the address in Hamburg, because it is specific
enough to be interpreted without the extra location context:
&at=52.531,13.3843
&q=Rathausstraße+3%2C+Hamburg
&pretty
If the search string is less specific, it will take the location context into account. The following query
will yield Rathausstraße 3 in Berlin, because we told the search engine that the location context is in
central Berlin:
&at=52.531,13.3843
&q=Rathausstraße+3
&pretty
Address search also finds post code areas. When searching in New York City, we can find Beverly Hills
by just entering 90210:
&at=40.7967,-73.9252
► User Guide
58
&q=90210
&pretty
Discovering a particular kind of place
In some cases users don't care about a specific place, they just need a particular kind of place, such
as a cafe in a certain area. In this case the places are ranked according to the place rating, which is
based on user interaction data and reviews. Here is an example to discover cafes in Berlin:
&at=52.531,13.3843
&q=cafe
&pretty
For certain places a ranking by rating is not helpful, because they are interchangeable. Examples of
such places include petrol stations, ATMs and different outlets of chain stores. Whenever the search
engine detects such a query they result are ordered by distance. An example would be to search for a
REWE supermarket near the HERE Berlin office:
&at=52.531,13.3848
&q=REWE
&pretty
Restricting search results
It is possible to restrict search results within a search area. If you are not willing to walk for more than
500m for your restaurant, consider the following query:
&in=52.531,13.3848;r=500
&q=restaurant
&pretty
Use your location
Additionally or alternatively to the explicit location context in the at and in parameter, an application
can set implicit location contexts. If the application has a user-visible map it can send the viewport the
user is currently looking at. The following example demonstrates a request with X-Map-Viewport
header using curl command line tool.
curl \
--compressed \
-H 'Accept-Encoding:gzip' \
► User Guide
59
-H 'Accept-Language:en-US,en;q=0.8,de;q=0.6,id;q=0.4' \
-H 'X-Map-Viewport:13.3704,52.5122,13.4194,52.5262' \
--get 'https://places.cit.api.here.com/places/v1/discover/search' \
--data-urlencode 'app_id={YOUR_APP_ID}' \
--data-urlencode 'app_code={YOUR_APP_CODE}' \
--data-urlencode 'q=restaurant' \
--data-urlencode 'pretty=true'
If the application has access to the user's position, it can send this as well:
curl \
--compressed \
-H 'Accept-Encoding:gzip' \
-H 'Accept-Language:en-US,en;q=0.8,de;q=0.6,id;q=0.4' \
-H 'Geolocation:geo:52.531,13.3843' \
--get 'https://places.cit.api.here.com/places/v1/discover/search' \
--data-urlencode 'app_id={YOUR_APP_ID}' \
--data-urlencode 'app_code={YOUR_APP_CODE}' \
--data-urlencode 'q=restaurant' \
--data-urlencode 'pretty=true'
Refine search results
Setting the refinements parameter allows for retrieving places and refined searches. A refined search
helps the search engine to deal with ambiguity in user queries. This allows the application to suggest
refinements to the user's search.
&at=52.531,13.3848
&q=Paris+Bar
&refinements=true
&pretty
Guiding free-text entry with suggestions
Sometimes, especially in mobile use cases, it is not practical to force the user to type in the whole
query. One way to deal with this is to use suggestions based on what the user has already entered.
This partial matching can be invoked multiple times, while the user is typing more characters to refine
the search.
Finding a specific place by it's name
Here is an example for suggestions offered for "madi" when standing in Bryant Park in New York,
which will offer the nearby "Madison Ave" as a possible result:
&at=40.7539,-73.9837
&q=madi
&pretty
60
► User Guide
Restricting suggestion types
By default autosuggest response could contain the following result types:
Result Type
Media Type
Description
address
urn:nlp-types:place
Location and address
suggestion
place
urn:nlp-types:place
POI suggestion
category
urn:nlp-types:search
Category search suggestion
chain
Chain/Brand search suggestion
61
► User Guide
Result Type
Media Type
Description
query
urn:nlp-types:autosuggest
Query completion suggestion
In some cases, like for example a navigation/guidance use case, user might want only to find only a
specific address or POI as destination.
For this kind of purpose, application developer could restrict the Autosuggest response by passing
the result_types=address,place query parameter in the request.
&at=52.531,13.3843
&q=garten
&result_types=address,place
&pretty
► User Guide
62
Using query completions
Application developer could also strict Autosuggest to return query completions only.
&at=40.7539,-73.9837
&q=mc
&result_types=query
&pretty
{
"results":[
{
"title":"mcdonald",
"highlightedTitle":"mcdonald",
"completion":"donald",
"href": "http://...",
"type":"urn:nlp-types:autosuggest"
},
{
"title":"mccarthy",
"highlightedTitle":"mccarthy",
"completion":"carthy",
"href": "http://...",
},
{
"title":"mcguinness",
"highlightedTitle":"mcguinness",
"completion":"guinness",
"href": "http://...",
},
...
]
}
The query completion results contain href attribute, which application developer can use to trigger
next Autosuggest request with the user's chosen completed query term.
► User Guide
63
Service Support
If you need assistance with this or other HERE products, please contact your HERE representative or
Technical Customer Support.
If you have technical questions about the HERE APIs, go to the HERE Stack Overflow page.
► API Reference
64
Chapter
4
API Reference
Topics:
•
Search Results Ranking
•
HTTP Request Headers
•
Request Entrypoints
•
Response Resources
•
HTTP Status Codes
•
Supported Chain and Catego...
This section provides a detailed explanation of all the resources
in the Places (Search) API, including header information, all of the
entrypoints, every media type, and an explanation of the typical
JSON Objects. There is also description of the categories feature
of Places (Search) API, as well as all relevant http status codes.
► API Reference
65
Search Results Ranking
HERE Search uses a machine learning system to rank search results, as do Google and Bing. The
system "learns" from real-world queries randomly sampled from search logs. Human annotators look
at the results provided by the system and rate them by quality. These ratings are fed back into the
system so that it can learn from its mistakes and constantly improve over time, adapting to changing
query types, new application releases and data updates, and the growing geographic distribution of
users.
There are many factors which influence the order of the search results. These include:
•
The quality of the string match between the query and the result, including the amount of spell
correction required
•
The distance between the user and the result, e.g. actual distance, whether the result is in the
same city as the user
•
The category or type of the result, e.g. address, city, restaurant, hotel
•
The popularity of the result, e.g. number of clicks, number of times it has been saved as a
"favorite"
•
The population for results such as cities or states
There are a few special cases where results are ranked using different methods.
•
Certain types of categories, such as restaurants or hotels, are ranked via a "recommendationsstyle" algorithm where measures of popularity or quality, such as number of stars or reviews, are
taken into account.
•
Other types of categories, such as gas stations, are ranked purely by distance.
•
Chain stores which are recognised as such by the system are also ranked purely by distance.
HTTP Request Headers
Important context information is passed to the Places (Search) API using optional HTTP request
headers. Wherever applicable the service relies on established and standardized headers,
complementing these with some additional private headers. Some of these directly affect the results,
while others help to optimize search results.
► API Reference
66
Header Name
Description
Accept
Specifies which media types are acceptable for the response (see Accept header
specification ). This header is ignored for JSONP requests, which always have an
application/javascript result media type. Defaults to application/json.
•
application/json results in a standard JSON response
•
application/xhtml+xml results in an XHTML representation of the JSON
response in our playground UI
•
text/html results in an HTML representation of the JSON response in our
playground UI
If the header is specified and no supported values are supplied, the result will be
an HTTP 406 Not Acceptable error response.
Accept-Language
The user or client's preferred languages (see Accept-Language header
specification). This value is used to select the language of content in the response.
Default: en.
Date
The user's local time, for example, Mon, 08 Aug 2011 11:58:17 GMT (see
Date header specification).
User-Agent
A string identifying the client user agent (see User-Agent header specification),
used for statistical purposes. If the Places (Search) API is accessed from within a
web browser, the browser should send this information automatically. For other
applications, it may need to be explicitly set by the application.
Accept-Encoding
Allows clients to enable compressed transfer of responses. The only supported
value is gzip . Clients are strongly encouraged to make use of that option, as
it can have a major impact on the responsiveness and performance of the client
application (see Accept-Encoding header specification).
Geolocation
The user's current position, formatted as a 'geo' URI as described in the Position
Format documentation. (see HTTP Geolocation Internet-Draft). In the absence
of an explicit location context, this is used to calculate the distance from the user
returned in place results, and can act as an implicit location context. To ensure the
best results possible, client applications should always send this header if it is able
to determine the user's position.
X-Map-Viewport
The bounding box of the map area currently visible to the user, formatted as
described in the Bounding Box Format on page 43 documentation. The viewport
can act as an implicit location context in the absence of an explicit location context.
To ensure the best results possible, client applications should always send this
header if it is able to determine the user's position.
X-Mobility-Mode
This header allows an application to indicate the user's means of transport, which
can help Places (Search) API return better results:
•
walk indicates that the user is on foot.
•
drive indicates that the user is driving.
► API Reference
Header Name
Description
•
X-MapVersion
67
none if the user is neither on foot nor driving.
If an application is using HERE map tiles and displaying a specific version of the
tiles, the application can specify the map version using this header to ensure that
returned place coordinates match the tiles you are using. The header value has
the form map-type:map-version . For example, nlp-tiles:2.1, nlptiles:latest, or nlp-hybrid:8.0.47.117. If this header is not sent, Places
(Search) API assumes nlp-tiles:latest.
X-NLP-Testing
Used signal that a request is a test request, which won't influence our search
relevance model.
•
1 identifies the request as a test request.
•
0 causes the request to be treated normally.
Defaults to 0.
X-Political-View
Specify the political view. Available territories will be seen through the point of
view of this country. If this parameter is not specified the neutral international
view is made available, where territories may have unresolved claims. The country
of the view is to be specified as ISO 3166-1-alpha-3 string.
X-VIN
If request originates from motor vehicle, this header can be used to specify the
Vehicle Identification Number (VIN) as per ISO 3779
Request Entrypoints
The Places (Search) API provides various resources that represent entrypoints into the places service.
Search & Discovery Entrypoints provide the fundamental entrypoints of the Places (Search) API
and are the first step in the User Flow. Additional Entrypoints occasionally occur before or after the
typical user flow.
For each of the entrypoints below, there is a description of several aspects: Resource URI, Resource
Parameters, HTTP Method, Request Example, Response Example, Response Media Type, and
Representation Modifiers.
•
Resource URI – identifies the appropriate coding to be included in a request header in order to
use the resource (along with some of the parameters). For example, with the Search Resource
URI as /discover/search?q=...&[at=...], a developer needs to include /discover/
search with the parameters of q and at. To see how to organize each resource and the resulting
parameters, see the Request Example for reach resource.
► API Reference
•
68
Resource Parameters – are base parameters for each resource. Each resource has different
parameters with differing levels of requirement which is explained under each respective
resource.
•
HTTP Method – indicates the desired action to be performed on the identified resource.
•
Request Example – Is an example showing the proper way to send a request for the given
Resource. Note that the each example includes the Resource URI, the appropriate parameters for
that Resource URI (for example q and at for the Search resource), the authorization credentials,
app_id an app_code, and some additional standardized REST parameters (like pretty for
pretty printing).
•
Response Media Type- is the appropriate Media Type for that Resource. Media types are
additional resources that work with their parent resource to offer additional optional information
or usability.
•
Representation Modifiers- API media types allow applications to adjust the presentation of the
returned response to suit their needs. Applications can activate the various tailoring options
by passing a series of options as additional query string parameters to the request. For each
Resource there is listed a number of parameters that are appropriate for that particular
Resource.
•
Response Example – is an example response from the Places (Search) API servers for the given
Resource Entrypoint (for example for the “search” Resource Entrypoint). This information is
represented in the JSON representation.
Search & Discovery Entrypoints
Search & Discovery Entrypoints are the starting point for all application interactions with the Places
(Search) API. Such entrypoints allow for the retrieval of the full description of places (with the place
resource entrypoint) along with the searching or discovery of these places (among many other
functions).
This section also includes a description of the Places Categories--a method to describe and group
places.
Autosuggest Entrypoint
The Autosuggest Entrypoint represents lists of suggested search terms, instants results and
refined search links related to a given (partial) search term and location context. This entrypoint is
used to help users save time, iterate on their searches, and get the results.
As-you-type-suggestion features of Autosuggest:
•
auto-suggest - exploratory search queries
69
► API Reference
•
disambiguation - providing end-user with contextual information to refine search
•
instant results of POI and addresses
•
follow link (href) in instant results and refine search results
•
highlighted result title text based on what the user typed in
The Autosuggest Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/autosuggest
Entrypoint Parameters
Parameter
Type
Description
at
Position (format:
Coordinates of search location expressed
as latitude, longitude. Additional
latitude,longitude[;cgen=(map|
gps|sgps)][;u=\d+]);
parameters can be passed which provide
required, unless one of
more context such as the uncertainty and
the Geolocation or X-Map-
how the coordinates were generated. For
Viewport headers or the in example, "52.5304417,13.4111201",
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
For a full description, see the Location
Contexts documentation.
q
String; required
Plain-text search term. For example,
"restaurant" or "Brandenburger Tor"
in
Area; required, unless one
This parameter limits results to the
of the Geolocation or X-
boundary of the specified area. The
Map-Viewport headers or
search area can be expressed as:
the at parameter are set.
•
circle specified as a centre point
with latitude and longitude; and a
radius around that point. Format:
latitude,longitude;r=\\d+(\\.\\d+)?
[;cgen=(map|gps|sgps)][;u=\\d+]
•
bounding box specified as 4
values, denoting west longitude,
70
► API Reference
Parameter
Type
Description
south latitude, east longitude, north
latitude.
•
polygon (Experimental)
defined by the coordinates (latitude,
longitude) of each of the polygon's
point. At least 4 coordinates (8
values) are required. The first and the
last coordinate must be the same
result_types
Comma-separated list of
A list of the autosuggest result types
result type strings; optional that should be included in the response.
Possible values are: address, place,
category, chain. If this parameter is not
set, all autosuggest types are considered
for the response.
hlStart
String; optional
The delimiter that should be placed
before each matched token in the
autosuggest response. It defaults to. The delimiters are included in the
'highlightedTitle' and 'highlightedVicinity'
fields.
hlEnd
String; optional
The delimiter that should be placed
after each matched token in the
autosuggest response. It defaults to . The delimiters are included in the
'highlightedTitle' and 'highlightedVicinity'
fields.
GET Method
The GET method returns the list of suggested queries, places and address as well as query
completions related to the partial search term.
71
► API Reference
The method allows applications to provide to application users query completion suggestions as they
type.
The following options are available in this context:
Parameter
Type
Description
size
Number (non-negative
The maximum number of result items in
integer); optional
each collection.
For additional information and examples, see Representation Modifiers on page 46.
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:autosuggest media type.
See the urn:nlp-types:autosuggest media type documentation for details about the structure
and content of the response.
Request Example
&at=52.5304417,13.4111201
&q=rest
&pretty
Response Example
{
"results": [
{
"title": "restaurant",
"highlightedTitle": "restaurant",
"category": "restaurant",
},
{
"title": "rest area",
"highlightedTitle": "rest area",
"category": "toilet-rest-area",
},
...,
{
"title": "Restaurant im Fernsehturm",
"highlightedTitle": "Restaurant im Fernsehturm",
"vicinity": "Panoramastraße 1 10178 Berlin",
72
► API Reference
"highlightedVicinity": "Panoramastraße 1 10178 Berlin",
"position": [ 52.52131, 13.40971 ],
},
{
"title": "Restaurant Marinelli",
"highlightedTitle": "Restaurant Marinelli",
"vicinity": "Anhalter Straße 1 10963 Berlin",
"highlightedVicinity": "Anhalter Straße 1 10963 Berlin",
"position": [ 52.50461, 13.38277 ],
"category": "restaurant",
},
...,
{
"title": "Restaurant",
"completion": "aurant",
"type": "urn:nlp-types:autosuggest"
}
]
}
Search Entrypoint
The Search Entrypoint processes text string queries based on the user's input to find specific
places. It answers questions of "what" and "where" for an online search of POI or address.
The results of the Search Entrypoint are sets of places that match a user's search term in a specific
location context (such as near a given location, around a user's current position or on the currently
visible map).
The Search Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/discover/search
Parameter
Type
Description
at
Position (format:
example, "52.5304417,13.4111201",
"52.5304417,13.4111201;cgen=gps;u=100"
73
► API Reference
Parameter
Type
Description
Viewport headers or the in or "52.5304417,13.4111201;u=100".
are set.
q
String; required
in
•
•
latitude.
•
cs
Comma-separated list;
A comma-separated ordered list of
optional
category systems defining which
type of category systems should be
returned in the response. For example
cs=places,cuisines
74
► API Reference
GET Method
The GET method provides access to places matching the given term.
Parameter
Type
Description
size
integer); optional
each collection.
String; optional; default:
Text format. Determines how rich text
html.
properties such as location.address.text
tf
should be rendered.
show_refs
•
html
•
plain
A list of one or more external system
optional
names or reference types. This parameter
exposes place related external references
in response. For a full description see
Representation Modifiers documentation.
show_content
A list of one or more available content
optional
types you can add to the response. For
a full description see Representation
Modifiers documentation.
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:search media type. See the
urn:nlp-types:search media type documentation for details about the structure and content of
the response.
► API Reference
Request Example
&at=52.5044,13.3909
&q=restaurant
&pretty
Response Example
{
"search" : {
"context" : {
"title" : "Paris",
"location": {
"position": [48.85692,2.34121],
"address": {
"city": "Paris",
"text": "Paris France"
},
"type" : "urn:nlp-types:place"
}
},
"results" : {
"items" : [
{
"position": [52.5031395, 13.3906403],
"distance": 0,
"title": "Wilhelm & Medne",
"averageRating" : 5.0,
"category": {
"href": "http://..."
},
"icon": "http://...",
"vicinity": "Hedemannstrasse 14 10969 Berlin Germany",
"href": "http://...",
"type": "urn:nlp-types:place",
"sponsored" : true,
"id": "276u33d8-efb829f5b9464e5db8f286ff5fbf5643"
},
{
"position": [52.5046, 13.39087],
"distance": 11,
"title": "Speakers Corner",
"averageRating" : 0.0,
"category": {
},
"icon": "http://...",
"vicinity": "Friedrichstrasse 31 10969 Berlin Germany",
"href": "http://...",
"id": "276u33d8-b08d10d141e4405fbfdabbf017571401"
}
]
}
}
75
76
► API Reference
Voice Search Entrypoint
The Voice Entrypoint processes text string queries based on the user's voice input to find specific
places. It answers questions of "what" and "where" for an online search of POI or address.
The results of the Voice Entrypoint are sets of places that match a user's search term in a specific
location context (such as near a given location, around a user's current position or on the currently
visible map).
The Voice Search Entrypoint is a Places (Search) API Premium entrypoint.
Note:
This is a premium feature. Contact your HERE representative or contact us through
developer.here.com to request the appropriate license if this feature is not already covered by
your agreement.
Entrypoint URI
/discover/voice
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
q
String; required
in
77
► API Reference
Parameter
Type
Description
•
•
latitude.
•
cs
optional
cs=places,cuisines
GET Method
Parameter
Type
Description
size
integer); optional
each collection.
78
► API Reference
Parameter
Type
Description
tf
html.
should be rendered.
show_refs
•
html
•
plain
optional
show_content
optional
Response Media Type
the response.
Request Example
https://places.cit.api.here.com/places/v1/discover/voice
&at=52.521,13.3807
&q=Find+me+Munich
&pretty
Response Example
{
"results": {
"items": [
{
► API Reference
"position": [ 48.13641, 11.57754 ],
"bbox": [ 11.36772, 48.06307, 11.72033, 48.24597],
"distance": 504295,
"title": "Munich",
"category": {
"id": "city-town-village",
"title": "City, Town or Village",
"href": "http://...",
"system": "places"
},
"icon": "http://...",
"vicinity": "Bavaria Germany",
"having": [],
"href": "http://...",
"id": "276u281z-0b68e34139d74c61ac81ce05264aa4b6"
},
{
"position": [ 48.3583, 11.78427 ],
"distance": 476701,
"title": "Munich Airport (MUC)",
"averageRating": 4.8,
"category": {
"id": "airport",
"title": "Airport",
"href": "http://...",
"system": "places"
},
"icon": "https://...",
"vicinity": "Terminalstraße West 85356 Oberding",
"having": [],
"href": "http://...",
"id": "276u287h-33978e49adeb4b2fa026780cb8d88bef"
},
{
"position": [ 52.511929, 13.45483 ],
"distance": 5133,
"title": "Munich Sedcard Berlin",
"averageRating": 0,
"category": {
"id": "business-services",
"title": "Business & Services",
"href": "http://...",
"system": "places"
},
"icon": "http://...",
"vicinity": "Grünberger Str. 48 10245 Berlin",
"having": [],
"href": "http://...",
"id": "2768lxx5-73767d4de52d09c962f15cb017d9ef19"
}
]
},
"search": {
"context": {
"location": {
"position": [ 52.521, 13.3807 ],
"address": {
"text": "Luisenstraße 35 10117 Berlin Germany",
"house": "35",
"street": "Luisenstraße",
"district": "Mitte",
"city": "Berlin",
"county": "Berlin",
79
80
► API Reference
"stateCode": "Berlin",
"country": "Germany",
"countryCode": "DEU"
}
},
}
}
}
Explore Entrypoint
The Explore Entrypoint retrieves a list of relevant places nearby a given position or area. It answers
the question "What interesting places are in the viewport of the map?" The results presented to
the user are confined to those located in the current map view or search area and are ordered by
popularity.
Users can optionally provide categories of places they are interested in.
As with other entrypoints, the location to be used should be passed as a location context.
Note: Two critical parameters for the Explore Entrypoint entrypoint, at and in, are mutually
exclusive and can't be passed at the same time.
The Explore Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/discover/explore
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
81
► API Reference
Parameter
Type
Description
in
•
•
latitude.
•
cat
A comma-separated list of categorie
optional
ids defining an OR-filter that all places
reachable through the resource must
match. For a list of supported categories,
see the Categories documentation.
Resources without an explicit category
set will use an appropriate set of
categories to find popular places within
the given location context.
drilldown
Boolean; optional
If this flag is set to "true", result set
will contain links to a further discover
query based on the current query. For
example result set may contain discover
82
► API Reference
Parameter
Type
Description
query links that restrict result set to a
certain category (category drill down). To
request a further drill down or in this case
example, to expose subcategory filters on
chosen discover query, application has to
append the drilldown=true parameter to
the chosen discovery query link.
cs
•
false
•
true
optional
cs=places,cuisines
GET Method
The GET method provides access to popular places for the given location context and matching the
category filter criteria.
Depending on the location context, the number of relevant places might be large. Therefore the GET
method may not only return places, but also suggestions for additional filter criteria that allow users
to interactively refine the classes of places they are interested in.
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
83
► API Reference
Parameter
Type
Description
show_refs
•
html
•
plain
optional
show_content
optional
Response Media Type
the response.
Request Example
https://places.cit.api.here.com/places/v1/discover/explore
&at=52.50449,13.39091
&pretty
Response Example
{
"search": {
"context": {
"location": {
"position": [53, 14]
}
}
},
"results":{
"items":[
{
► API Reference
84
"position": [52.498619, 13.37681],
"distance": 1159,
"title": "German Museum of Technology Berlin (Deutsches Technikmuseum
Berlin)",
"averageRating": 5,
"category": {
"id": "landmark-attraction",
"title": "Landmark/Attraction",
"href": "http://...",
"type": "urn:nlp-types:category"
},
"icon": "http://...",
"vicinity": "Trebbiner 9\n10963 Berlin\nGermany",
"id": "276u33d8-1cca7647c58a49d3a86b884a923ffa19"
},
{
"title": "Eat & Drink",
"icon": "http://...",
"type": "urn:nlp-types:search",
},
{
"title": "Going Out",
"icon": "http://...",
},
{
"title": "Sights & Museums",
"icon": "http://...",
}
]
}
}
Browse Entrypoint
The Browse Entrypoint represent sets of places within a specific location context sorted by
distance.
The Browse Entrypoint allows users to request places around a given point. The Browse Entrypoint's
location context might be an explicitly given location, it might be implicitly defined by a user's current
position, or it might be implicitly defined by the currently visible map. Optionally, the places may be
restricted to a given set of categories (which acts as a filter in terms of what places get returned).
at and in parameter are mutually exclusive and can't be passed at the same time
The Browse Entrypoint is a Places (Search) API Premium entrypoint.
Note:
your agreement.
85
► API Reference
Entrypoint URI
/browse
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
in
•
•
latitude.
•
86
► API Reference
Parameter
Type
Description
name
String; optional
Plain-text name of a place used to
filter out the results. For example,
"Brandenburger Tor"
cat
optional
cs
optional
cs=places,cuisines
GET Method
The GET method provides access to places for the given location context and matching the category
filter criteria.
Parameter
Type
Description
size
integer); optional
each collection.
87
► API Reference
Parameter
Type
Description
tf
html.
should be rendered.
show_refs
•
html
•
plain
optional
show_content
optional
Response Media Type
the response.
Request Example
https://places.cit.api.here.com/places/v1/browse
&in=52.521,13.3807;r=2000
&cat=petrol-station
&pretty
Response Example
{
"search": {
"context": {
"location": {
► API Reference
88
"position": [52.521, 13.3807]
}
}
},
"results": {
"items": [
{
"position": [52.528678, 13.36969],
"distance": 1135,
"title": "Steffen Kolberg Tankstellen Verwaltungs- und Betriebs GmbH",
"averageRating": 0,
"category": {
"id": "petrol-station",
"title": "Petrol station",
"href": "http://...",
},
"icon": "http://...",
"vicinity": "Heidestr. 65-68\n10557 Berlin",
"href": "http://...",
"id": "276u33db-f2d1758f279348c1b134676cbcffdb81"
},
{
"position": [52.533179, 13.37976],
"distance": 1357,
"title": "Total Station Inh. Hans-Jürgen Klasen",
"averageRating": 5,
"category": {
"href": "http://...",
},
"icon": "http://...",
"vicinity": "Chausseestr. 98\n10115 Berlin",
"href": "http://...",
"id": "276u33db-dfb5ec1fed614c7fa7f10df85bf986cf",
}
]
}
}
Browse by Corridor Entrypoint
The Browse by Corridor Entrypoint represent sets of places along a route area sorted by distance
from starting point of the route.
The Browse by Corridor Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/browse/by-corridor
89
► API Reference
Parameter
Type
route
Route (format:
Description
This parameter limits search results to
\[start(latitude,longitude)|
the boundary of an area around a route.
A route consists of a start coordinate,
0..n(latitude,longitude)|
0..n turning coordinates and an end
end(latitude,longitude)\]
coordinate. An optional width in meters
[;w=\d+]); required
can be passed to provide off the route
max distance in meters, default: 1000m
The points should describe the geometric
shape of the route with high precision.
Especially, it’s usually not sufficient to
only pass maneuvre points as they would
be shown to the driver.
There are practical limitations to URL
lengths. Thus, if the route has more
than 120 points or URL length is over
2000 characters, the corridor shortener
endpoint should be considered to POST
the route.
An alternative way to reduce URL length is
to use Google's polyline encoding format.
In this case the square brackets should
be omitted. Width is supported in normal
way. For example, route=_ky~H_oaoA?
_ibE_th~C~mbJ;w=5000
cat
required
90
► API Reference
Parameter
Type
Description
name
String; optional
"Brandenburger Tor"
cs
optional
cs=places,cuisines
GET Method
The GET method provides access to places for the given route and matching the category filter
criteria.
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
show_refs
•
html
•
plain
optional
91
► API Reference
Parameter
Type
Description
show_content
optional
Response Media Type
the response.
Request Example
Find petrol stations within a route corridor area between Berlin and Hamburg with 1 km off route
distance.
► API Reference
92
► API Reference
93
In the following request example, URL encoding is omitted for better readability. An actual request
would need to be URL encoded.
https://places.cit.api.here.com/places/v1/browse/by-corridor
&route=[52.5160,13.3771|52.5111,13.3712|52.5355,13.3634|52.5400,13.3704|52.5626,13.3307|
52.5665,13.3076|52.6007,13.2806|52.6135,13.2484|52.6303,13.2406|52.6651,13.2410|
52.7074,13.1926|52.7045,13.0661|52.7191,12.9621|52.7636,12.8263|52.7861,12.8000|
52.8335,12.7919|52.9002,12.7451|52.9708,12.6311|53.0526,12.5392|53.0867,12.5169|
53.1146,12.4687|53.1334,12.4644|53.1415,12.4225|53.1666,12.3722|53.1785,12.3050|
53.2570,12.1618|53.2893,12.0618|53.3000,11.9373|53.3316,11.8724|53.3463,11.8190|
53.3669,11.7328|53.3725,11.6427|53.4154,11.5505|53.4309,11.4906|53.4342,11.4000|
53.4655,11.3370|53.4873,11.2631|53.4860,11.2011|53.5110,10.9647|53.5128,10.8414|
53.5495,10.6892|53.5692,10.5155|53.5596,10.4259|53.5682,10.2999|53.5571,10.2020|
53.5672,10.1279|53.5534,9.9924];w=1000
&cat=petrol-station
&pretty
Response Example
{
"results": {
"items": [
{
"position": [52.53723, 13.37472],
"distance": 277,
"title": "Total",
"category": {
"href": "http://...",
},
"icon": "http://...",
"vicinity": "Chausseestraße 62 10115 Berlin",
"having": [],
"href": "http://...",
"id": "276u33db-cc5a1377043842ba8fc3c6acd0b36e7d"
},
{
"position": [52.542679, 13.37774],
"distance": 822,
"title": "Esso Station Mathias Fuhrmann",
"category": {
"href": "http://...",
},
"icon": "http://...",
"vicinity": "Gerichtstr. 4 13347 Berlin",
"having": [],
"href": "http://...",
"id": "276u33db-be2f5afbd0e3458b9ad8410ed578fef7"
},
{
"position": [52.53391, 13.36515],
"distance": 839,
"title": "Total",
94
► API Reference
"category": {
"href": "http://...",
},
"icon": "http://download.vcdn.data.here.com/p/d/places2/icons/
categories/18.icon",
"vicinity": "Heidestraße 19 10557 Berlin",
"having": [],
"href": "http://...",
"id": "276u33db-6bcb7b2e4fec41e9a295bba5709b00e4"
},
...
],
"search": {
"context": {
"location": {
"position": [52.5353, 13.3773]
}
}
}
}
}
Here Entrypoint
The Here Entrypoint helps users identify places at their location or at a point selected on a map by
returning places close to a given point, sorted by distance. Normally the closest known places are
returned, but if the uncertainty in the position is high then some nearer places are excluded from the
result in favour of more popular places in the area of uncertainty.
This entrypoint can be used to help users answer questions like "Where am I?" and "What is at this
point on the map?". You can use this endpoint to implement features like "check-in" (by identifying
places at the user's current geo-position) or "click on map to get more information".
As with other entrypoints, the location to be used should be passed as a location context.
The Here Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/discover/here
Parameter
Type
Description
at
Position (format:
95
► API Reference
Parameter
Type
Description
are set.
"52.5304417,13.4111201;cgen=gps;u=100"
or "52.5304417,13.4111201;u=100".
cat
optional
drilldown
Boolean; optional
cs
•
false
•
true
optional
96
► API Reference
Parameter
Type
Description
cs=places,cuisines
building
A comma-separated list of 3D
optional
building ids defining an OR-filter
that all places reachable through the
resource must match., For example
building=1,9000000000000870709.
Building filter can be used for indoor
navigation, e.g. searches in big shops/
malls. Building Ids are available for clients
who use Enterprise SDKs or have access
to map content by other means.
GET Method
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
•
html
•
plain
97
► API Reference
Parameter
Type
Description
show_refs
optional
show_content
optional
Response Media Type
the response.
Request Example
https://places.cit.api.here.com/places/v1/discover/here
&at=52.50449,13.39091
&pretty
Response Example
{
"search": {
"context": {
"location": {
}
}
},
"results":{
"items":[
{
"position": [52.498619, 13.37681],
"distance": 1159,
Berlin)",
"averageRating": 5,
"category": {
98
► API Reference
"href": "http://...",
},
"icon": "http://...",
},
{
"icon": "http://...",
},
{
"icon": "http://...",
},
{
"icon": "http://...",
}
]
}
}
Around Entrypoint
The Around Entrypoint represents sets of places within a specific location context, usually the
location of the user. This Entrypoint is intended for applications that employ features such as
augmented reality, where places around the user's location are displayed on a device. It is intended
to provide places that are likely to be visible to the user as well as important places that are further
away.
The Around Entrypoint allows users to request places near to a given point, based on a location
precision parameter. The places around that point are returned in order of proximity.
The Around Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/discover/around
Parameter
Type
Description
at
Position (format:
99
► API Reference
Parameter
Type
Description
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
in
•
•
latitude.
•
cat
optional
100
► API Reference
Parameter
Type
Description
drilldown
Boolean; optional
cs
•
false
•
true
optional
cs=places,cuisines
GET Method
This method is intended for applications such as augmented reality, where places around the user's
location are displayed on a device. It is intended to provide places that are likely to be visible to the
user as well as important places that are further away.
101
► API Reference
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
show_refs
•
html
•
plain
optional
show_content
optional
Response Media Type
the response.
► API Reference
Request Example
https://places.cit.api.here.com/places/v1/discover/around
&at=52.50449,13.39091
&pretty
Response Example
{
"search": {
"context": {
"location": {
}
}
},
"results":{
"items":[
{
"position": [52.498619, 13.37681],
"distance": 1159,
Berlin)",
"averageRating": 5,
"category": {
"href": "http://...",
},
"icon": "http://...",
},
{
"icon": "http://...",
},
{
"icon": "http://...",
},
{
"icon": "http://...",
}
]
}
}
102
103
► API Reference
Suggest Entrypoint
The Suggest Entrypoint represents lists of suggested search terms related to a given (partial)
search term and location context. This entrypoint is used to help users to provide suggested search
terms to the user while typing.
The Suggest Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/suggest
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
q
String; required
GET Method
The GET method returns the list of suggested search terms related to the partial search term.
The method allows applications to provide to application users query completion suggestions as they
type.
104
► API Reference
Parameter
Type
Description
size
integer); optional
each collection.
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:suggest media type. See the
urn:nlp-types:suggest media type documentation for details about the structure and content of
the response.
Request Example
https://places.cit.api.here.com/places/v1/suggest
&at=52.5304417,13.4111201
&q=rest
&pretty
Response Example
{
"suggestions": [
"Restaurant",
"Restaurant Fleischerei Berlin",
"Restorf, Lüchow-Dannenberg",
"Rest area",
"Restaurant Fleischerei",
"Restaurant und Caffee Marrakesch",
"Simplicity Restaurant",
"Restaurant \"das pfeffer\"",
"Las Olas-Restaurant GmbH & Co.KG",
"Ars Vini 1. Berliner Fondue Restaurant",
"Yam Yam Korean Restaurant",
"Restaurant Blaues Band",
"Kaffeehaus & Restaurant K\u00fcrbis Inh. Simon Eder",
"Kaffeehaus & Restaurant Kurbis",
"Restaurant Schmitz",
"Restaurant Luso",
"www.partycard.de Club Bar Restaurant Kino Food Disco Sport Berlin",
"Aapka - indisches Restaurant Berlin",
"Restaurant Frarosa"
]
}
105
► API Reference
Browse-Pt-Stops Entrypoint
Note: The Browse Public Transport (PT) Stops Entrypoint is deprecated. Please use The
Public Transit API
The Browse Public Transport (PT) Stops Entrypoint allows users to request public transit stops
that are within two kilometer radius from the given location.
The results returned are sorted by increasing distance from the given location.
The location context might be an explicitly given location or it might be implicitly defined by a user’s
current position.
The Browse-Pt-Stops Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/browse/pt-stops
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
GET Method
The GET method provides access to public transport stops for the given location context.
► API Reference
106
Response Media Type
the response.
Request Example
https://places.cit.api.here.com/places/v1/browse/pt-stops
&at=52.531,13.3848
&pretty
Response Example
{
"results": {
"items": [
{
"position": [
52.520551,
13.380001
],
"distance": 69,
"title": "Marschallbrücke",
"category": {
"id": "public-transport",
"title": "Public Transport",
"href": "http://...",
"system": "places"
},
"icon": "http://...",
"vicinity": "Luisenstraße 32 10117 Berlin Germany",
"having": [],
"id": "ptdmVyc2lvbj0xO2xhdD01Mi41MjA1NTE7bG9uPTEzLjM4MDAwMTtjYXRlZ29yeUlkPXB1YmxpYy10cmFuc3BvcnQ7aWQ9dmJiXzkxMDA1Mj
"transitLines": {
"text": "Bus TXL",
"label": "Transport lines",
"lines": {
"Bus TXL": {
"name": "Bus TXL",
"category": {
"id": "5",
"title": "Bus"
},
"style": {
"color": "#7D176B",
"textColor": "#FFFFFF",
"iconShape": "rectangle"
}
}
},
"destinations": [
{
"destination": "Flughafen Tegel Airport",
"line": "Bus TXL"
► API Reference
107
},
{
"destination": "S+U Alexanderplatz",
"line": "Bus TXL"
}
]
}
},
{
"position": [
52.522427,
13.378675
],
"distance": 209,
"title": "Karlplatz",
"category": {
"id": "public-transport",
"title": "Public Transport",
"href": "http://...",
"system": "places"
},
"icon": "http://...",
"vicinity": "Reinhardtstraße 45 10117 Berlin Germany",
"having": [],
"href": "http://...",
"id": "ptdmVyc2lvbj0xO2xhdD01Mi41MjI0Mjc7bG9uPTEzLjM3ODY3NTtjYXRlZ29yeUlkPXB1YmxpYy10cmFuc3BvcnQ7aWQ9dmJiXzkxMDA1MD
"transitLines": {
"text": "Bus 147, Bus TXL",
"label": "Transport lines",
"lines": {
"Bus 147": {
"name": "Bus 147",
"category": {
"id": "5",
"title": "Bus"
},
"style": {
"color": "#7D176B",
}
},
"Bus TXL": {
"name": "Bus TXL",
"category": {
"id": "5",
"title": "Bus"
},
"style": {
"color": "#7D176B",
}
}
},
"destinations": [
{
"destination": "Fahrt endet hier",
"line": "Bus 147"
},
{
"destination": "Flughafen Tegel Airport",
"line": "Bus TXL"
},
{
"destination": "S Ostbahnhof",
"line": "Bus 147"
► API Reference
},
{
"destination": "S Ostbahnhof",
"line": "Bus 147"
},
{
"destination": "S+U Alexanderplatz",
"line": "Bus TXL"
},
{
"destination": "S+U Berlin Hauptbahnhof",
"line": "Bus 147"
},
{
"destination": "S+U Brandenburger Tor",
"line": "Bus 147"
},
{
"destination": "S+U Brandenburger Tor/Glinkastr.",
"line": "Bus 147"
},
{
"destination": "S+U Hauptbahnhof",
"line": "Bus 147"
},
{
"destination": "U Märkisches Museum",
"line": "Bus 147"
},
{
"destination": "U Märkisches Museum",
"line": "Bus 147"
}
]
}
}
.
.
.
]
}
"search": {
"context": {
"location": {
"position": [
52.521,
13.3807
],
"address": {
"text": "Luisenstraße 35 10117 Berlin Germany",
"house": "35",
"street": "Luisenstraße",
"city": "Berlin",
"county": "Berlin",
}
},
}
}
}
108
109
► API Reference
Two-Box-Search Entrypoint
Note: The Two-Box-Search Entrypoint is deprecated.
The Two-Box-Search Entrypoint processes text string queries based on the user's input to find
specific places. It answers questions of "what" and "where" for an online search of POI or address.
The results of the Two Box Search Entrypoint are sets of places that match a user's search term in a
specific given location term.
The Two-Box-Search Entrypoint is a Places (Search) API Premium entrypoint.
Note:
your agreement.
Entrypoint URI
/discover/two-box
Parameter
Type
Description
where
String; required
Location-text. For example, "DEU",
"Berlin" or "Berlin Mitte"
what
String; required
in
Area; optional
•
•
110
► API Reference
Parameter
Type
Description
latitude.
•
cs
optional
cs=places,cuisines
GET Method
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
•
html
•
plain
111
► API Reference
Parameter
Type
Description
show_refs
optional
show_content
optional
Response Media Type
the response.
Request Example
https://places.cit.api.here.com/places/v1/discover/two-box
&where=Berlin
&what=restaurant
&in=6.2719,47.7468,14.7732,54.9044
&pretty
Response Example
{
"results": {
"items": [
{
"position": [ 52.530227, 13.385666 ],
"distance": 34,
"title": "Restaurant Reinstoff",
"category": {
"id": "restaurant",
"href": "http://...",
},
"icon": "http://...",
"vicinity": "Schlegelstraße 26c 10115 Berlin Germany",
"having": [],
► API Reference
112
"href": "http://...",
"id": "276u33db-4fa5ad4c78f5488d865a534344604dcb"
},
{
"position": [ 52.5304, 13.3867 ],
"distance": 97,
"title": "Auberge Maréchal Ney",
"averageRating": 0,
"category": {
"id": "restaurant",
"href": "http://...",
},
"icon": "http://...",
"vicinity": "Schlegelstraße 22 10115 Berlin Germany",
"having": [ "owner" ],
"href": "http://...",
"id": "276u33db-e79fb3eb9a254aebab75cb7febb19eff"
}
]
},
"search": {
"context": {
"location": {
"position": [ 52.530411, 13.38527 ],
"address": {
"text": "Invalidenstraße 117 10115 Berlin Germany",
"house": "117",
"street": "Invalidenstraße",
"city": "Berlin",
"county": "Berlin",
},
"bbox": [ 13.383422, 52.529287, 13.387118, 52.531535 ]
},
}
}
}
Tiles Entrypoint
The tiles feature allows you to request place recommendations for areas of the map that are
displayed to the user by requesting place tiles covering individual map tiles, in the same way that
visual map data can be be requested a tile at a time. As the user moves the map, you request place
tiles covering newly displayed areas. Place tiles requests are more cacheable than requests to the
explore endpoint, resulting in better response times and the user experience in applications that
allow map panning, and enabling us to serve them through a CDN, which can improve load times for
all users. A place tile looks like a normal explore result only that the area is defined by a map tile.
The Tiles Entrypoint retrieves a list of base URLs which encode the criteria specified in the request,
and which can be used to construct URLs for individual place tiles. A list of base URLs is provided so
113
► API Reference
that you can overcome typical web browser restrictions that limit the number of parallel requests to a
single domain, e.g. by random or round-robin selection of a base URL when requesting individual tiles.
To request an actual tile, the tile address (zoom, column and row) has to be appended to the base
URL. Zoom, column and row parameters follow the tile addressing schema of the HERE Map Tile API.
The Tiles Entrypoint is a Places (Search) API Premium entrypoint.
Note:
your agreement.
Entrypoint URI
/tiles
Parameter
Type
Description
cat
optional
cs
optional
cs=places,cuisines
GET Method
The GET method provides access to a list of base URLs for the given criteria.
114
► API Reference
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
show_refs
•
html
•
plain
optional
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:tile-links media type. See
the urn:nlp-types:tile-links media type documentation for details about the structure and
content of the response.
Request Example
https://places.cit.api.here.com/places/v1/tiles?app_id={YOUR_APP_ID}
&pretty
Response Example
{
"tiles": [
"http://.../places/v1/tiles/
c2l6ZT0yMCZsYW5ndWFnZXM9ZW4tVVMlMkNlbiUyQ2RlJTJDcnUlMkN1ayZzZXFfbnVtYmVyPTEmY3JlYXRlZD0xMzk5NjMxNDgzMDUx/"
115
► API Reference
"http://../places/v1/tiles/
c2l6ZT0yMCZsYW5ndWFnZXM9ZW4tVVMlMkNlbiUyQ2RlJTJDcnUlMkN1ayZzZXFfbnVtYmVyPTImY3JlYXRlZD0xMzk5NjMxNDgzMDUx/"
....,
"http://.../places/v1/tiles/
c2l6ZT0yMCZsYW5ndWFnZXM9ZW4tVVMlMkNlbiUyQ2RlJTJDcnUlMkN1ayZzZXFfbnVtYmVyPTMmY3JlYXRlZD0xMzk5NjMxNDgzMDUx/"
]
}
Additional Entrypoints
While using the Places (Search) API, developers will most commonly use the Search & Discovery
entrypoints since they always represent the first step in the User Flow. In addition to these
entrypoints, there are also Additional Entrypoints. The agent entrypoints allow for additional
functionality on top of the typical entrypoints required for the User Flow. This section describes each
additional entrypoint in detail.
Lookup Entrypoint
Endpoint provides ability to find a place by its foreign ID. Successful request results in redirect (HTTP
status code 302) to the place resource with context added.
For more information how to retrieve foreign IDs, please see User Guide External References on page
44
The Lookup Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/places/lookup
Parameter
Type
Description
source
String; required
Name of the foreign ID source in lower
case (e.g. pvid).
•
pvid: Core POI
•
venues.content: Venue content ID
•
venues.destination: Venue
destination ID
•
venues.venue: Venue ID
116
► API Reference
Parameter
Type
Description
id
String; required
The ID of the requested place in foreign
system.
GET Method
GET method provides lookup ability.
Request Example
https://places.cit.api.here.com/places/v1/places/lookup
&source=pvid
&id=1115664033
Response Example
{ "href" : "http://places.cit.api.here.com/places/v1/
places/276u33dc-3944a4748a62499cb795cf8bee349c9c;context=Zmxvdy1pZD0wMjI3Y2JiNy1kYzBmLTVjYTAtYjFkMC1hM2QyM
app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}" }
Place Categories Entrypoint
This entrypoint is used to obtain the place categories available for a given location. This entrypoint
might be used to give a user a list of categories to choose from. The Place Categories Entrypoint
represents sets of locally relevant categories that are organized in a directed acyclic graph. The
category graph may change in the future and may differ depending on the location of the request. A
set of permanent, top-level, place categories can be found at Categories.
The Place Categories Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/categories/places
117
► API Reference
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
in
•
•
latitude.
•
► API Reference
118
GET Method
The GET method provides access to the place categories relevant to a given position. When no such
location is provided with the request, the response contains the graph with all place categories
recognized by the API.
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:category-graph media
type. See the urn:nlp-types:category-graph media type documentation for details about the
structure and content of the response.
Request Example
https://places.cit.api.here.com/places/v1/categories/places
&at=52.50449,13.39091
&pretty
Response Example
{
"items": [
{
"id": "eat-drink",
"icon": "http://...",
"href": "http://...",
"within": [ ]
},
{
"id": "restaurant",
"icon": "http://...",
"href": "http://...",
"within": [ "eat-drink" ]
},
{
"id": "snacks-fast-food",
"title": "Snacks/Fast food",
"icon": "http://...",
"href": "http://...",
"within": [ "eat-drink" ]
},
...
]
}
119
► API Reference
Cuisine Categories Entrypoint
This entrypoint is used to obtain the cuisine categories available for a given location. This entrypoint
might be used to give a user a list of categories to choose from. The Cuisine Categories Entrypoint
represents sets of locally relevant categories that are organized in a directed acyclic graph. The
category graph may change in the future and may differ depending on the location of the request.
The Cuisine Categories Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/categories/cuisines
Parameter
Type
Description
at
Position (format:
"52.5304417,13.4111201;cgen=gps;u=100"
are set.
or "52.5304417,13.4111201;u=100".
in
•
•
120
► API Reference
Parameter
Type
Description
latitude.
•
GET Method
The GET method provides access to the cuisine categories relevant to a given position. When no such
location is provided with the request, the response contains the graph with all cuisine categories
recognized by the API.
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:category-graph media
type. See the urn:nlp-types:category-graph media type documentation for details about the
structure and content of the response.
Request Example
https://places.cit.api.here.com/places/v1/categories/cuisines
&at=52.50449,13.39091
&pretty
Response Example
{
"items": [
{
"id": "cuisines",
"title": "Cuisines",
"href": "http://...",
"within": [ "eat-drink", "food-drink" ]
},
{
► API Reference
121
"id": "cuisines.barbecue",
"title": "Barbecue",
"href": "http://...",
"within": [ "cuisines" ]
},
{
"id": "cuisines.burger",
"title": "Burgers",
"href": "http://...",
"within": [ "cuisines" ]
},
...
]
}
Actions Entrypoint
The Actions Entrypoint is used to send tracking actions so that they can be logged.
Providing tracking information is important for the reasons described in Client Tracking, in short,
to improve Search and Discovery responses to users. Places (Search) API can track some actions
based upon URLs that are requested. When this is not possible, the information must be provided by
different means. The actions entrypoint can be used to provide this information.
The Actions Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/actions
POST Method
The POST method allows a single action or a batch of actions to be uploaded in the post body. The
request must have a Content-Type of application/json, and the post body must match the
action-post media type.
Example for the POST request:
https://places.cit.api.here.com/places/v1/actions
&pretty
Request body:
{
"actions": [
{
"resource": "http://places.cit.api.here.com/places/v1/
places/276u33db-5e332e9253f94042a3f086a2c19ea4bb;context=Zmxvdy1pZD1kNTQwYzMzZC1kYmI1LTU2NDQtYmI5Yi1jZDZlZ
app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}",
"types": [
122
► API Reference
"urn:nlp-actions:placeselected",
"urn:nlp-actions:viewplaceonmap"
],
"timestamp": "2013-07-12T14:34:10.763+0100"
},
{
places/276u33db-2c192376ea8541419d3e26bc4aa4f7f9;context=Zmxvdy1pZD1kNTQwYzMzZC1kYmI1LTU2NDQtYmI5Yi1jZDZlZ
"types": [
"urn:nlp-actions:drivingdirections"
],
"timestamp": "2013-07-12T14:38:10.763+0100"
}
]
}
GET Method
If an application is not able to use the POST method, it can also trigger a GET request. In this case,
only a single action can be submitted per request. The request consists of various query parameters
—resource, client, timestamp and type. These fields are identical to those described in the actionpost media type's Action sub-object.
Note: The parameters parameter field is supported only for the POST method.
Example for the GET request:
https://places.cit.api.here.com/places/v1/actions
?resource=https%3a%2f%2fplaces.cit.api.here.com%2fplaces
%2fv1%2fplaces%2f250u09tu-4561b8da952f4fd79c4e1998c3fcf032%3bcontext
%3dZmxvdy1pZD04YWYwMDY2MC00MzZmLTU1ZWItYTdhOC1hZDU3YTE4MmMwMjdfMTQwOTA2NjUxOTQwMV8wXzYxMjYmcmFuaz0w
%3fapp_id%3d{YOUR_APP_ID}&app_code%3d{YOUR_APP_CODE}
&types=urn:nlp-actions:phonenumberclicked
&timestamp=2012-07-01T12%3A13%3A14.123%2B0200
&pretty
Action Type URNs
The following is a list of action type URNs that we suggest to use for some of the actions that we
expect to be made with Places (Search) API places. This list is not intended to be exhaustive.
Type
Description
urn:nlp-actions:viewplaceonmap
View place on map.
urn:nlp-actions:emailclicked
Click on place e-mail.
urn:nlp-actions:websitelinkclicked
Click on place website URL.
urn:nlp-actions:phonenumberclicked
Click on place phone number.
123
► API Reference
Type
Description
urn:nlp-actions:pinnedtohomescreen
Pin place to home screen.
urn:nlp-actions:shareplace
Share place to external service.
urn:nlp-actions:addplacetocollection
Add place to collection/favourites.
urn:nlp-actions:walkingdirections
Generate walking directions to/via place.
urn:nlp-actions:drivingdirections
Generate driving directions to/via place.
urn:nlp-actions:publictransportdirections
Generate public transport directions to/via place.
Corridor Shortener Entrypoint
The Corridor Shortener Entrypoint shortens Browse by Corridor Entrypoint's route parameter using
Google's polyline encoding format and additionally simplifies it with Radial-Distance algorithm (fast)
or Douglas-Peucker (high quality) algorithm if necessary.
With most of the devices it is not possible to use Corridor Entrypoint with URL of more than 2000
characters. Additionally, it is not recommended to have unencoded routes with more than 120
coordinates. To overcome the size limits, this entrypoint could be used to reduce the length of the
URL. The result of this entrypoint contains an URL that should be used for subsequent corridor
requests.
If encoding the coordinates is not sufficient to reduce URL length, simplifying algorithm is applied. In
the process of simplification deviation can emerge. To cover the same space of an original route we
provide a new corridor width.
The Corridor Shortener Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/browse/by-corridor/short
Parameter
Type
Description
cat
optional
124
► API Reference
Parameter
Type
Description
name
String; optional
"Brandenburger Tor"
cs
optional
cs=places,cuisines
POST Method
The POST method provides access to the object that contains simplified corridor route and new
corridor width. The request must have a Content-Type of application/json.
Parameter
Type
Description
size
integer); optional
each collection.
html.
tf
should be rendered.
•
html
•
plain
125
► API Reference
Parameter
Type
Description
show_refs
optional
show_content
optional
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:simplified-corridor
media type. See the urn:nlp-types:simplified-corridor media type documentation for
details about the structure and content of the response.
Request Example
Shortens URL for a route corridor with more than 150 coordinates and 2 km off route distance.
https://places.cit.api.here.com/places/v1/browse/by-corridor/short
&cat=petrol-station
&pretty
Request body
{
"route": "[49.2403332,9.1021303|49.2403793,9.1014647|49.2403686,9.1013467|
49.2403042,9.1010356|49.2399824,9.0998662|49.2397356,9.0991151|49.2396605,9.0987933|
49.2395747,9.0982568|49.2394996,9.0956497|49.2394888,9.0953493|49.2395639,9.0953171|
49.2396069,9.0952528|49.2396283,9.0951347|49.2396069,9.0950274|49.2395639,9.0949631|
49.2394888,9.0949309|49.2394137,9.0942764|49.239285,9.0937293|49.2386949,9.0917552|
49.2385983,9.0913475|49.2384696,9.0907252|49.2382765,9.0895021|49.2382014,9.0887403|
49.2381692,9.0882146|49.2381585,9.0872383|49.2381907,9.086498|49.2382872,9.0853608|
49.2389095,9.0811014|49.2390382,9.0799642|49.2390811,9.0793526|49.2390811,9.078902|
49.2390597,9.0785265|49.2389739,9.0777647|49.238888,9.0773678|49.2387378,9.0767884|
49.2381692,9.0771747|49.2372572,9.0777433|49.2367744,9.0779901|49.2357981,9.0784514|
49.2350578,9.0787196|49.2347252,9.0788269|49.2337489,9.0790951|49.2330301,9.0792239|
49.2321718,9.0793204|49.2315602,9.0793419|49.2311311,9.0793312|49.2304659,9.0792775|
49.2300153,9.0792239|49.2293608,9.0790951|49.2289102,9.0789771|49.228245,9.0787303|
49.2267323,9.0781295|49.2262924,9.0780008|49.2258418,9.0778935|49.2253911,9.0778184|
49.2249298,9.0777862|49.2243505,9.0777969|49.2239213,9.0778399|49.2235243,9.077915|
49.2228055,9.0781081|49.2223442,9.0782797|49.2218935,9.0784943|49.2214537,9.0787303|
► API Reference
126
49.2208636,9.0791166|49.2203379,9.0795457|49.218353,9.0813804|49.2178166,9.0817988|
49.2174625,9.0820348|49.2169046,9.0823352|49.2165399,9.082464|49.215982,9.082582|
49.2155313,9.0825927|49.2152417,9.0825605|49.2148662,9.0824747|49.2145014,9.082346|
49.2141366,9.0821743|49.213568,9.0817773|49.2131495,9.0814018|49.2129028,9.0811229|
49.2124414,9.0804684|49.2122912,9.0802217|49.211905,9.0794706|49.2118406,9.0793097|
49.2116368,9.0787411|49.2111003,9.0768421|49.210875,9.0758657|49.2113471,9.0756083|
49.2114866,9.0755332|49.2116261,9.0754151|49.2117655,9.0752649|49.211905,9.0750611|
49.2119908,9.0748894|49.2121196,9.0744603|49.2121518,9.0742886|49.2121732,9.0737844|
49.2121518,9.0735269|49.2120445,9.0730655|49.2119265,9.0726471|49.211905,9.0724325|
49.211905,9.0722179|49.2119265,9.0720141|49.2120123,9.0715635|49.2123878,9.0706515|
49.212935,9.0692139|49.2132461,9.068259|49.2135251,9.0673578|49.2138791,9.0660918|
49.2142224,9.0646434|49.2144048,9.0637422|49.2147052,9.0621114|49.2148447,9.0611351|
49.2149949,9.0598154|49.2150915,9.0588284|49.2151451,9.0580988|49.2152417,9.0559852|
49.2152309,9.0537429|49.2151451,9.051801|49.2149734,9.0499771|49.2147911,9.0484107|
49.214201,9.0437651|49.2139864,9.0418124|49.2139006,9.0408254|49.2136967,9.0379715|
49.2136216,9.0360832|49.2136002,9.0352464|49.2135894,9.0322745|49.2136323,9.0307617|
49.2136645,9.0303433|49.2137074,9.0290129|49.2137933,9.0277362|49.2139864,9.0250862|
49.2141151,9.0236485|49.214437,9.0206659|49.2147803,9.0178871|49.2154777,9.0130484|
49.217838,8.9994013|49.2180741,8.9981461|49.219265,8.991183|49.2208743,8.9820421|
49.221282,8.9795423|49.2216039,8.9773428|49.221915,8.9748108];w=2000"
}
Response Example
{
"href": "http://.../places/v1/corridor?
size=20&offset=0&app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}&route=agpkHiwpv@GdC@VJ|
@~@hFp@tCL~@PjBNhO@z@ODGJCVBTFJNDLbCXlBtBhKRpAXzBd@rFLvCFhB@bEGrCQ`F{BrYYbFIxB?
xADjANvCPnA\rBpBmAtDqB~Aq@bE{ArCs@ÀUbEu@lCYjDSxBCtA@dCJxAH`CXxAVdCn@lHxBvAVxATxAN|
ADpBAtAGnAOnCe@zAa@xAk@vAo@tBkAhBuAjKoJjBqAdAo@nB{@hAYlBWxAAx@DjAPfAXhA`@pBnArAhAn@v@zAbC
\n@lAtCJ`@h@nBhBzJl@bE}Ar@[L[V[\[f@Qb@WrAGb@CbBBr@TzAVrABh@?
j@Cf@QxAiAtDmB~G}@~Dw@rDeAzFeA`Hc@rD{@dI[bE]fGSdEIpCSdL@~LPbK`@lJb@vHtB`\
\j@dKNdEh@xPLxJBfDBpQIlHErAGhGQ~Fe@pOY~G_ArQeAjPiCf]wMftAo@zFmFnj@aIbx@qArN_AvL}@xN;w=1000&cat=petrolstation;w=2097&cat=petrol-station",
"newCorridorWidth": 2097
}
Health Entrypoint
The Health Entrypoint can be used to check the availability of the Places (Search) API as part of a
monitoring system.
Note: The license does not allow the use of any other requests to the Places (Search) API as
part of a health check or monitoring scheme.
The Health Entrypoint is a Places (Search) API Core entrypoint.
Entrypoint URI
/health
GET Method
Returns a response status of 200 OK to indicate that the system is up and running.
► API Reference
127
Note: Common problems, such as incorrect proxy configurations, firewall configuration
issues, or networking problems, will typically not yield a response at all but rather a connection
timeout.
Request Example
https://places.cit.api.here.com/places/v1/health
&pretty
Response Example
{
"message":"The Places API is up and running"
}
Entrypoint maturity and availability
Places (Search) API entrypoints can be divided into the three following categories:
•
Core entrypoints are available to all users of Places (Search) API. They are fully supported and
mature. Following are Places (Search) API core entrypoints:
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
•
Autosuggest –– Get autocomplete suggestions for search queries.
Search –– Find places using a text query.
Explore –– Find recommended places in a location.
Here –– Identify places at location.
Around –– Find places around a location. Similar to explore, but optimized for 3D visualexploration overlays.
Browse by Corridor –– Find places with certain categories within a corridor area
Corridor Shortener –– Simplifies route required for the corridor search
Lookup –– Find a place by non-Place ID, e.g. PVID.
Place Categories –– Get place categories that are supported within a region.
Cuisine Categories –– Get cuisine categories that are supported within a region.
Suggest –– Get autocomplete suggestions for search queries.
Browse-Pt-Stops –– Find public transport places around a location sorted by distance
Actions –– Report user interactions
Health –– Monitor the availability of the service
Premium entrypoints are mature but only available on request. Please contact your sales
representative to get access to them. Following are Places (Search) API premium entrypoints:
◦
◦
Voice Search –– Find places using a text query produced by some voice recognition software
Browse –– Find places with certain categories around a location sorted by distance
128
► API Reference
◦
Tiles –– Retrieves a list tiles base URLs for the given criteria
Two-Box-Search –– Find places using two text queries.
◦
Response Resources
This section provides reference to the data structures used throughout the Places (Search) API.
Media Types
Media Types explains the data structure types that are received in responses from and sent in
requests to Places (Search) API. All responses from the Places (Search) API and requests bodies sent
to the Places (Search) API are in the format defined by a media type. For example, places, images,
reviews, and more are are sent and received as media types.
Search Media Type
The search media type describes a step in a user activity to find/discover places.
Media Type URI
Media Type Structure
The representation provides some information about the search request, but the primary
information in the search media type is a list of result items that guide users directly or indirectly to
the place(s) they are looking for. This media type has the following format:
{
"search": {
//...
},
"results" : {
"items": [
//...
]
}
}
Attribute
Type
Description
results
Object[DiscoverResultSet]
a paginateable collection of
search result items.
129
► API Reference
Attribute
Type
Description
search
Object[SearchDescription]
search location context that
the service has chosen for the
query.
Search Description
Attribute
Type
Description
context
Object[SearchContext]
search context information
Search Context Information
The primary information about the search context is the location context that the service has
chosen for the query. Usually the location context is derived from the explicit location parameters
of a discover activity. But sometimes the location context is also derived from other elements,
particularly from a user's search term. For example, when a user located in "Berlin, Germany" uses
the search term is "Restaurant in Paris", the search algorithm uses "Paris" as the search location.
When the location context of a place discovery is derived from one of the explicit location
parameters, the selected one is returned in the result. Depending on the endpoint used, it may also
contain an address or area of the location:
{
"search": {
"context": {
"title": "Paris",
"location": {
"position": [52.5044, 13.3909]
"address": {
"city": "Paris",
"text": "Paris France"
//...
}
},
}
//...
}
}
Result items of type search contain the context used for the search, which includes the following
attributes:
130
► API Reference
Attribute
Type
Description
title
String (formatted text); optional
A (short) textual representation
of the item
location
Object[SearchLocation]
The location used for the
search.
type
String
The type of the resource being
linked to. The value is either
a valid MIME media type or a
URI. Places (Search) API internal
links always use a URN in the
namespace "nlp-types" for the
type attribute. If missing, the
link goes to a web resource that
is best opened in a universal
http client, like a web browser.
href
String (URI); optional
A hyperlink that refers to the
resource represented by that
result item.
moved
Boolean; optional
If true, the location used for
the search is different from the
one provided in the request.
Search Location
Attribute
Type
Description
position
Array[Number]
A position given by latitude
and longitude, for example
[37.785141,-122.4047775]
address
Object[Address]; optional
The neighborhood of the
location used for the search.
bbox
Array[Number]; optional
An enclosing rectangle
that describes a range of
131
► API Reference
Attribute
Type
Description
coordinates corresponding
to the location of the place.
Bounding boxes are typically
associated with places such as
cities and countries. A bounding
box is specified as an array
([West longitude, South latitude,
East longitude, North latitude])
according to the GeoJSON
geospatial data interchange
format.
Search Results Media Type
The search-results media type is the structure used for the search results attribute.
Media Type URI
urn:nlp-types:search-results
The representation provides a paginateable list of result items that guide users directly or indirectly
to the place(s) they are looking for.
{
"results" : {
"next": "http://...",
"offset": 20,
"items": [
//...
]
}
}
Attribute
Type
Description
previous
The URI to the subresource
holding the previous page of the
collection. If the current page is
132
► API Reference
Attribute
Type
Description
the first page of the collection,
the attribute is not present.
next
holding the next page of the
the last page of the collection,
offset
Number (integer); optional
Pages other than the first page
of a collection may include this
attribute. If present, it contains
the index of the first item in the
current page.
items
Array[PlaceLink | SearchLink]
There are several different
types of result items, but
regardless of its specific type,
each result item is a link object.
The goal of all discovery resources is to guide a user to a place, but this might not always be possible
or appropriate in a single step. For example, there may be too many candidates and therefore the
user might want to define additional criteria. Therefore some result items directly link to a place,
while others link to different resources that can be presented to the user and contain further links via
which the user will be linked to a place.
Each resource item has a `type` field identifying the type of page that it links to. The current
implementation of the Places (Search) API supports two types:
Place Media
A user selecting the item in a Place Link will be directed to a place.
Type on page
133 (urn:nlptypes:place)
Search Media
A user selecting the item in a Search Link will trigger a refined/more precise
Type on page
search query. This type of result item may appear when the amount of
128 (urn:nlp-
reasonable matches is too large and the service can offer additional criteria
types:search)
that may be used to refine the query.
133
► API Reference
Upcoming releases may introduce additional types (e.g. events). Clients must be prepared to handle
that situation and ignore any results that have a `type` that they don't know how to handle.
Place Media Type
A place response, identified by media type URI urn:nlp-types:place, contains all the information
available for a single place.
The place representation is extensible, with attributes divided into four sections:
Base attributes
A set of predefined attributes providing core information about a place like
name, location, and categories.
Extended attributes
An extensible collection of additional facts about the place
Media collections
A set of rich media types aggregated from multiple sources
Related places
References to other places related to the given place
Base attributes are members of the place object itself, while extended attributes, media collections
and related places are each grouped under their own subobject:
{
"name": "Rockefeller Center",
//... other base attributes
"extended": {
//... extended attributes
},
"media": {
//... media collections
},
"related": {
//... related places
}
}
Base Attributes
Base place attributes are members of the place object that provide core information about a place.
Attribute
Type
Description
name
String
The name of the place. If a
user's preferred language is
English and the place has an
alternative name in English, the
English name would be returned
134
► API Reference
Attribute
Type
Description
as the place name and the
original name would be present
in the alternativeNames
attribute.
placeId
String
The unique identifier of the
place.
view
String (URI)
A URI linking to a representation
of the place that can be viewed
by end users. Applications must
provide at least a link for every
place that is fetched.
Note: The link in the
place.view attribute
can be used to enable
users to share a place
with their friends. For
more information on
this feature, please see
Place Sharing
alternativeNames
Array[AlternativeName];
Original names of a place,
optional
including possibly those in other
languages.
location
Object[Location]
A description of the physical
location of a place.
attribution
A ready-to-display string
containing the source attribution
text for this place.
via
Object[Link]; optional
A link object to the external
website of the supplier of the
place. Where possible, this is
a deeplink to a page specific
to the place. As documented
135
► API Reference
Attribute
Type
Description
in Source Attribution on page
35, this link must be used
for attribution when rich text
attribution is not being used.
supplier
A link to metadata about the
supplier of the place. The object
extends the standard link object
with an optional icon attribute
that contains a URI string
pointing to the supplier's brand
icon.
references
Object(map of String to
A map from third-party names
Reference); optional
to the unique identifier that the
third party uses for this place.
contacts
Object[Contacts]
An object listing means of
contacting the place
categories
Array[Link]; optional
An array of link objects to
categories assigned to the
place. A category link object
with an optional icon attribute,
pointing to an icon appropriate
for that category.
icon
String (URI)
A URI linking to a representation
of the place that can be viewed
by end users. Applications must
provide for every place they
fetch at least a link.
ratings
Object[Ratings]; optional
An object summarizing the user
ratings for a place. Deprecated.
Replaced by Rating Media
136
► API Reference
Attribute
Type
Description
Type on page 149 in media
collections
report
A link for getting options for
reporting a place because,
for example, it contains
inappropriate content or place
does not exists. The response
will have the report-options
media type.
Additional Place Information
Attribute
Type
Description
extended
Object[ExtendedAttributes];
An object that provides further
optional
information about a place
Object[Related]
An object that contains related
related
places in which users may also
be interested.
media
Object[Media]
An object containing collections
of media (images, reviews, etc.)
relating to the place.
phonemes
Object[PlacePhonemes];
Phonetic information for this
optional
place.
Note:
This is a premium
feature. Contact your
HERE representative
or contact us through
developer.here.com to
request the appropriate
license if this feature is
137
► API Reference
Attribute
Type
Description
not already covered by
your agreement.
Alternative Name
Each alternative name is an object providing the alternative name as well as information on the
language of that name.
Attribute
Type
Description
name
String
the alternative name
language
String[language tag]
the ISO language code
Location
A location object contains attributes to describe the physical location of a place.
Attribute
Type
Description
position
Array[Number]
[37.785141,-122.4047775]
locationId
String; optional
A unique identifier of the
location when assigned.
address
The neighborhood of the
location used for the search.
bbox
138
► API Reference
Attribute
Type
Description
format.
access
Array[AccessPoint]; optional
Coordinates to access the
location.
Ratings
A summary of how users rated a place.
Attribute
Type
Description
average
Number
The average rating of the place
across all users.
count
Number (integer)
The number of individual votes
on the place.
Extended Attributes
If a place has no information for a given attribute, the attribute is not present. If there is no extended
content at all for a place, the extended attribute of the place is not present.
In the future, more properties may be added to the extended section. Clients can safely loop over all
properties in this section and use the label and text properties to display all available information
in this section to the user. When an attribute represents a list of options, the text field separates the
elements with newlines.
The currently available extended properties may include third-party content as described in media
collections.
Some extended attributes may provide a structured presentation in addition to the label/text
representation (e.g. transitLines). They will be documented separately.
139
► API Reference
Attribute
Type
Description
payment
Object[ExtendedAttribute];
A list of available payment
optional
methods (such as cash, credit
card, direct debit, etc.)
openingHours
Object[OpeningHours]; optional A list of hours during which the
place is open for business.
annualClosings
A description of annual closing
optional
dates such as holidays or other
special occasions.
price
A price list.
optional
fuelPrices
optional
Fuel price list.
Note:
This is a premium
HERE representative
your agreement.
nearestLandmark
languagesSpoken
availableParking
smoking
A description of the nearest
optional
landmark.
A list of the languages that are
optional
spoken at the place.
A list of parking options
optional
available nearby.
Whether smoking is allowed.
optional
disabledAccess
Whether disabled access is
optional
available.
140
► API Reference
Attribute
Type
Description
transitLines
Object[TransitLines]; optional
A list of available public
transport transit lines.
departures
Object[Departures]; optional
A list of next departures for
available public transport transit
lines.
Note:
This is a premium
HERE representative
your agreement.
blindGuide
Whether a public transport
optional
stop has blind guides ('tactile
paving').
disabledParkingSpaces
Whether disabled parking is
optional
available.
Note:
This is a premium
HERE representative
your agreement.
womenParkingSpaces
Whether women parking is
optional
available.
141
► API Reference
Attribute
Type
Description
Note:
This is a premium
HERE representative
your agreement.
restRoomAvailable
Whether rest room is available
optional
in parking place.
Note:
This is a premium
HERE representative
your agreement.
secureParking
Whether parking is secured,
optional
indicates a gated and CCTV
parking.
Note:
This is a premium
HERE representative
142
► API Reference
Attribute
Type
Description
your agreement.
securityManned
Whether security guard is
optional
available in parking place.
Note:
This is a premium
HERE representative
your agreement.
electricalChargingPoints
Whether electric charging point
optional
is available in parking place.
Note:
This is a premium
HERE representative
your agreement.
elevator
Whether a place has an elevator.
optional
escalator
Whether a place has an
optional
escalator.
143
► API Reference
Departures Extended Attribute
Departures Extended Attribute is associated with public transport stop/station and contains
information about scheduled departures from the place:
Attribute
Type
Description
text
String (formatted text)
The information in rich text
which can be displayed directly.
If the text represents a list of
items, the items are separated
by a line break entity (if the text
format is html) or newline (if the
text format is plain).
label
String
A localized display label for that
extended attribute
via
information. As documented
attribution
schedule
Object[Schedule]; optional
List of next public transport
departures.
Schedule
Information about the departures of public transport stop/station. Departure items are paginated
based on page size parameter.
144
► API Reference
Attribute
Type
Description
next
Link to the next set of
departures, if available.
items
Array[Departure]
List of departures.
lines
Dictionary of lines serving
TransitLine); optional
departures shown in current
departure item list using line
name as a key.
operators
Dictionary of public transport
PTOperator); optional
operators operating on this
stop/station using operator ID
as a key.
Departure
Information about single departure. All times use RFC 3339 date-time format with timezone offset
Attribute
Type
Description
line
String
Reference to the line in lines
dictionary.
scheduled
Object[DepartureTime]
Originally scheduled departure
time.
direction
String; optional
Direction of the departure on its
line.
exception
String; optional
An indicator for some
exceptional event happened to
this departure. Possible values
are redirected, replaced,
cancelled and additional.
operator
String; optional
A reference to the operator in
the operators dictionary.
145
► API Reference
Attribute
Type
Description
real
Object[DepartureTime]; optional A real time information about
departure time.
extended
Array[ExtendedAttribute];
A dictionary describing
optional
additional features of the
departure. Supported keys
are bikeAllowed and
barrierFree.
DepartureTime
Information about departure time.
Attribute
Type
Description
platform
String; optional
Platform for the departure.
Attribute
Type
Description
id
String
Id.
title
String; optional
Name of the operator
supplier
Object[OperatorSupplier];
Supplier of the operator's
optional
schedule information
Dictionary of additional links
OperatorLink); optional
to be display next to departure
PTOperator
Public transport operator.
links
information of the operator.
Possible keys are operator,
agency and tariff.
146
► API Reference
OperatorSupplier
Supplier of the public transport operator's schedule.
Attribute
Type
Description
title
String
Name
OperatorLink
Additional link associated with operator.
Attribute
Type
Description
text
Text for the link.
url
Object[Link]
URI of the link.
Related Places
The related object contains related places in which users may also be interested. The following
properties may be available:
Attribute
Type
Description
recommended
A link list of recommended
places for the given place which
shares the same structure as
the search results.
public-transport
A link list of nearby public
transports for the given place
which shares the same structure
as the search results.
venue
Object[PlaceLink]; optional
Venue where place resides
stops
A link list of public transport
connections in the given place
which shares the same structure
as the search results.
147
► API Reference
Media Object Structure
A Media Object Structure contains third-party content collections. This object contains the
following attributes:
Attribute
Type
Description
images
Object[MediaCollection]
collection of images of a place
editorials
Object[MediaCollection];
collection of editorial
optional
description about a place
collection of reviews about a
reviews
place
links
ratings
Object[MediaCollection];
collection of links for
optional
interactions with a place
collection of rating summaries
from suppliers
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);
The date the review was
optional
uploaded.
title
String; optional
The review's title
rating
Number; optional
A rating for the place, on a scale
of 1 to 5.
description
The review itself.
user
Object[User]; optional
The user who made the review
148
► API Reference
Attribute
Type
Description
language
String (RFC 5646 language tag); The language of the review
optional
report
reporting a review because,
inappropriate content. The
response will have the reportoptions media type.
via
supplier
attribution
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",
"icon": "https://...",
"type": "text/html"
},
"language": "en",
"supplier": {
"id": "here",
"title": "HERE",
"href": "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": {
149
► API Reference
"title": "Report this review",
"href": "http://...",
"type": "urn:nlp-types:report-options"
}
}
Rating Media Type
The rating media type summarises the ratings assigned to a place by a particular supplier.
Media Type URI
urn:nlp-types:rating
Attribute
Type
Description
count
The number of individual user
ratings that contributed to the
average rating.
average
Number; optional
via
supplier
attribution
Average user rating.
Image Media Type
The image media type represents an image of a place.
Media Type URI
urn:nlp-types:image
The image media media type has the following attributes:
Attribute
Type
Description
src
String (URI)
A URL to the actual image
150
► API Reference
Attribute
Type
Description
imageId
String
Identifier of image if uploaded
via Places (Search) API (this ID is
returned from an image upload
response)
date
dimensions
The date the image was
optional
uploaded.
Object(map of String to String);
A map containing links to the
optional
sized variants of the original
image.
user
Details of the user who
contributed the image.
report
reporting an image because,
inappropriate content. The
response will have the reportoptions media type.
via
supplier
attribution
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://...",
151
► API Reference
},
"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://...",
},
"attribution": "Provided by HERE member",
"user": {
"name": "anonymous"
},
"delete": {
"title": "Delete an image",
"href": "http://...",
"method": "DELETE"
}
}
Report Options Media Type
The report-options media type describes reporting options for current place/image/review
Media Type URI
urn:nlp-types:report-options
Attribute
Type
Description
inappropriate
A hyperlink to submitting an
inappropriate place/image/
review report.
non-existent
A hyperlink to submitting a nonexistent place report.
152
► API Reference
Report Post Media Type
The report post media type describes the fields that need to be provided in order to report a
place or media item.
Media Type URI
urn:nlp-types:report-post
Attribute
Type
Description
reason
String
The reason that a place/media
item is being reported, chosen
from the report options list
comment
String
A string in which the user
describes why the place/media
item is reported.
Category Media Type
The category media type contains meta-information about a category.
Media Type URI
urn:nlp-types:category
Attribute
Type
Description
categoryId
String
A unique category identifier. For
example, eat-drink.
name
String
The (localized) display name of
the category. For example, Eat
& Drink.
icon
The link to the category icon
system
String
Category system of the
category
153
► API Reference
Category Graph Media Type
The category-graph media type represents a set of categories with parent-child relationships
between them.
Media Type URI
urn:nlp-types:category-graph
The representation provides a paginateable list of result items, each of which represents a category
node. Each node contains a link to the related category resource and the category ids of its parents in
the graph.
The search results is a paginateable collection of result items.
Each result item is a CategoryGraphNode.
Attribute
Type
items
Array[CategoryGraphNode]
Description
Category Graph Node
Attribute
Type
Description
id
String
A unique category identifier
title
String
A localized title for the resource
to which the link refers. Clients
can display this title within their
application.
icon
type
String; optional
154
► API Reference
Attribute
Type
Description
href
String (URI)
A link to the category resource
represented by this graph node
system
String
Category system of the
category
within
Array[String]
An array with the category ids of
this node's parents
Supplier Media Type
The supplier media type contains meta-information about a supplier.
Media Type URI
urn:nlp-types:supplier
Attribute
Type
Description
supplierId
String
A unique supplier identifier
name
String
The (brand) name of the
supplier
icon
A link to the supplier's brand
icon
Suggestions Media Type
The suggestions media type contains a list of suggested search terms.
Media Type URI
urn:nlp-types:suggestions
155
► API Reference
For performance reasons, this media type doesn't use hypermedia links. Instead, clients processing
suggestion resources must use the suggested search term selected by their user as the value of the
q resource parameter to access a search resource.
The suggested search terms are exposed in a simple JSON object containing one attribute:
Attribute
Type
Description
suggestions
Array[String]
An array of suggested search
terms.
Action Post Media Type
The action media type describes a user interaction made against the Places (Search) API, for
example, the user clicking to the dial the phone number of a place.
Media Type URI
urn:nlp-types:action-post
Attribute
Type
Description
meta
Object[Meta]; optional
Meta information about the
operation to report actions.
actions
Array[Action]
The actions that are being
reported.
Meta Object
This object contains meta-information describing the upload of action information that is taking
place. The meta object object has the following attributes:
Attribute
Type
Description
currentTimestamp
String[DateTime]; optional
The time that the upload to the
Actions resource was made,
according to the clock from
156
► API Reference
Attribute
Type
Description
which the actions' timestamp
field values came from.
Action Object
The action object represents an interaction made against a place. It has the following attributes:
Attribute
Type
Description
resource
String
The URL in the Places (Search)
API of the place that the
reported action took place
against. For example, if the
action reported is a phone
number being called, this is the
URL of the place which had its
phone number called.
types
Array[String]
List of action type URNs. Each
URN represents a type of
action, and begins with "urn:nlpactions".
timestamp
String[DateTime]; optional
A date and time string
representing when the action
took place. Its format is yyyyMM-ddTHH:mm:ss.SSSZ.
client
String; optional
An identifier used to identify
different client devices, for
example in cases where cookies
can't be provided by the client
device
parameters
A map for passing any extra
optional
information with your action
post beyond what is contained
in the other fields.
157
► API Reference
Example
{
"actions": [
{
places/276u33db-5e332e9253f94042a3f086a2c19ea4bb;context=Zmxvdy1pZD1kNTQwYzMzZC1kYmI1LTU2NDQtYmI5Yi1jZDZlZ
"types": [
"urn:nlp-actions:viewplaceonmap"
],
"timestamp": "2013-07-12T14:34:10.763+0100"
},
{
places/276u33db-2c192376ea8541419d3e26bc4aa4f7f9;context=Zmxvdy1pZD1kNTQwYzMzZC1kYmI1LTU2NDQtYmI5Yi1jZDZlZ
"types": [
"urn:nlp-actions:drivingdirections"
],
"timestamp": "2013-07-12T14:38:10.763+0100"
}
]
}
Action Type URNs
The following is a list of action type URNs that we suggest to use for some of the actions that we
expect to be made with Places (Search) API places. This list is not intended to be exhaustive.
Type
Description
urn:nlp-actions:placeselected
Select place from a result list.
urn:nlp-actions:viewplaceonmap
View place on map.
urn:nlp-actions:emailclicked
Click on place e-mail.
urn:nlp-actions:websitelinkclicked
Click on place website URL.
urn:nlp-actions:phonenumberclicked
Click on place phone number.
urn:nlp-actions:pinnedtohomescreen
Pin place to home screen.
urn:nlp-actions:shareplace
Share place to external service.
urn:nlp-actions:addplacetocollection
Add place to collection/favourites.
urn:nlp-actions:walkingdirections
Generate walking directions to/via place.
urn:nlp-actions:drivingdirections
Generate driving directions to/via place.
urn:nlp-actions:publictransportdirections
Generate public transport directions to/via place.
158
► API Reference
Type
Description
urn:nlp-actions:navigationstarted
Start to follow navigation directions..
urn:nlp-actions:destinationreached
Arrive at navigation destination.
JSON Structure Objects and Attributes
JSON Structure Objects and Attributes describes the various object and attributes an application will
receive in a JSON representation.
JSON format uses objects and types of these objects can contain objects of their own, the terms
object and attribute can sometimes be used for the same item depending on the context of that
item. The definition of each term is as follows:
•
object - an object is a structure containing attributes. For example, place is an object
•
attribute - an attribute is a name and value that is part of its parent object. An attributes value
may be a string, another object, a hyperlink, or other information. For example, the place media
type has an attribute of alternativeNames which in turn has its own attribute of language
Link Object Structure
A link object is used to refer to other resources. This object contains the following attributes:
Attribute
Type
Description
id
String; optional
An identifier for the linked
object.
title
String; optional
A localized title for the resource
to which the link refers. Clients
can display this title within their
application.
href
String (URI)
The URI of the resource the link
object is referring to.
type
String; optional
159
► API Reference
Attribute
Type
Description
system
String; optional
The system name of the
resource being referenced
from.
accept
Array[String]; optional
List of accepted content media
type for POST request.
method
String; optional
Common method of HTTP/1.1
icon
A link to the icon for the linked
object, if one exists.
labels
An object containing a set of
LabelNode); optional
fields with translations required
for the UI
Label Node
A label nodeis an object containing a set of fields with translations required for the UI. The label
node contains the following attributes: This object contains the following attributes:
Attribute
Type
Description
label
String
the field
values
The (localized) values/options
LabelNode); optional
user can select from. Will be
provided for fields where user
should to choose one value
from provided options.
160
► API Reference
Collection Link
A link to a collection. Additional information is included that can be displayed to the user to help them
to decide if this is the collection they are interested in.
Attribute
Type
Description
title
String
The display name of this
collection item.
href
String (URI)
result item.
type
String
Favourite Place Link
A link to a favourite place.
Attribute
Type
Description
position
Array[Number]
[37.785141,-122.4047775]
distance
Distance to the destination in
meters calculated as described
in Search Location and Distance
Calculation.
161
► API Reference
Attribute
Type
Description
title
String
this item.
underlyingTitle
String; optional
The (localized) original display
name of place item.
category
Object[Link]
A hyperlink to the primary
category of the place.
icon
String (URI)
Icon associated with this item.
vicinity
The textual description of the
location of the place; usually
derived from the address of
the place, but may also contain
any other description that helps
a user understand where the
place is located.
type
String; optional
href
String (URI)
result item.
id
String
place.
162
► API Reference
Place Link
A link to a place. Additional information is included that can be displayed to the user to help them to
decide if this is the place they are interested in. It has the following attributes:
{
"position": [48.8582557, 2.2947905],
"distance": 881631,
"title": "Eiffel Tower",
"category": {
"href": "http://...",
},
"icon": "http://...",
"vicinity": "5 avenue Anatole France\n75007 Paris\nFrance",
"href": "http://...",
"id": "250u09tu-4561b8da952f4fd79c4e1998c3fcf032"
}
Attribute
Type
Description
position
Array[Number]
The latitude and longitude
of the place, for example
[37.785141,-122.4047775].
This latitude and longitude
is suitable for displaying the
place's position on a map.
bbox
format.
163
► API Reference
Attribute
Type
Description
distance
Distance to the destination in
meters calculated as described
in Search Location and Distance
Calculation.
title
String
this search item.
averageRating
Number; optional
Deprecated. The average rating
for a place; it is set to zero for
all places. For locations this field
is absent
category
A hyperlink to the primary
category of the place.
categories
Array[Link]; optional
An array of link objects to
categories assigned to the
place. A category link object
with an optional icon attribute,
pointing to an icon appropriate
for that category.
icon
String (URI)
Icon associated with this item.
vicinity
place is located.
address
The address of the place.
Note:
This is a premium
164
► API Reference
Attribute
Type
Description
HERE representative
your agreement.
contacts
Object[Contacts]; optional
An object listing means of
contacting the place
Note:
This is a premium
HERE representative
your agreement.
type
String; optional
href
String (URI)
result item.
165
► API Reference
Attribute
Type
Description
sponsored
Boolean; optional
If true, indicates that this
search result is sponsored.
Applications MUST provide
some visual differentiation for
sponsored search results from
regular (organic) ones.
distant
Boolean; optional
If true, indicates that this
search result is outside the
search context information.
id
String
place.
attribution
Note:
This is a premium
HERE representative
your agreement.
supplier
supplier of the place. The object
icon.
Note:
166
► API Reference
Attribute
Type
Description
This is a premium
HERE representative
your agreement.
via
place. Where possible, this is
a deeplink to a page specific
to the place. As documented
Note:
This is a premium
HERE representative
your agreement.
references
A property that provides a map
Reference); optional
of 3rd party unique identifiers
of the place or place's location.
weight
Number; optional
Number that can be used to
rank places between different
tiles (only for tiles request).
167
► API Reference
Attribute
Type
Description
Note:
This is a premium
HERE representative
your agreement.
transitLines
Object[TransitLines]; optional
A list of available public
transport transit lines.
access
Array[AccessPoint]; optional
List of access (navigation)
points for the place.
Note:
This is a premium
HERE representative
your agreement.
openingHours
Object[OpeningHours]; optional A list of hours during which the
place is open for business
fuelPrices
optional
Fuel price list.
Note:
This is a premium
HERE representative
168
► API Reference
Attribute
Type
Description
your agreement.
phonemes
Object[PlacePhonemes];
Phonetic information for this
optional
place.
Note:
This is a premium
HERE representative
your agreement.
Reference
A third-party identifier for a place or a place's location
{
"references": {
"pvid": {
"id": "36704368"
}
}
}
Attribute
Type
Description
id
String
a place or location reference.
alternatives
Array[Reference]; optional
alternative identifiers of the
same reference.
169
► API Reference
Transit Lines Extended Attribute
Transit Lines Extended Attribute is associated with public transport stop/station and contains
information about the lines and destinations:
Attribute
Type
Description
text
label
String
extended attribute
via
attribution
lines
destinations
Dictionary of public transport
TransitLine); optional
lines using this stop/station.
Array[Destination]; optional
Dictionary of destinations
served from this stop/station.
TransitLine
Public transport line.
170
► API Reference
Attribute
Type
Description
name
String
Name
category
Object[TransitLineCategory];
Category
optional
style
Object[TransitLineStyle];
Styling guidelines for the line.
optional
operator
String; optional
Operator serving the line.
TransitLineCategory
Category information for the public transport line.
Attribute
Type
Description
id
String
Unique id of the category.
title
String; optional
Localized name of the category.
localName
String; optional
Locally used name for the
category.
icon
String; optional
Icon for the category.
TransitLineStyle
Styling for the public transport line. All colors are in hex format.
Attribute
Type
Description
color
String; optional
The color value assigned to a
line.
textColor
String; optional
The text color that should get
used when the line color is used
as background color.
outlineColor
String; optional
Color of the border around the
line name.
171
► API Reference
Attribute
Type
Description
iconShape
String; optional
An enum identifying the shape
style of the icon.
Destination
Destination served from station/stop.
Attribute
Type
Description
destination
String
Name of the destination.
line
String
Name of the line serving the
destination.
AccessPoint
Access point for the location. Purpose of the access point is to provide location that can be used e.g.
for navigation.
Attribute
Type
Description
position
Array[Number]
The latitude and longitude of
the access point, for example
[37.785141,-122.4047775]
accessType
String
Type of access. As for now this
is always road.
sideOfStreet
Object[SideOfStreet]; optional
Side of the street relatively to
street direction
SideOfStreet
Opening Hours
The opening hours object contains opening hours information for a place. The following properties
may be available:
172
► API Reference
Attribute
Type
Description
text
label
String
extended attribute
via
attribution
isOpen
Boolean; optional
Boolean flag indicating whether
the place is currently open,
based on place's time zone.
structured
Array[StructuredOpeningHours]; List of structured presentations
optional
for opening hours.
Structured Opening Hours
Structure for holding opening hours based on the iCalendar specification.
This structure is defined so that it can describe more complex recurrence pattern like "Every 2nd
Saturday of the month from 10am to 10pm".
173
► API Reference
Unlike the iCalendar specification, the start value in our case does not contain a date part. We omit
the date part and immediately start with the T that is time section marker. For example, instead of
19700101T132000 you should expect a simpler T132000 equivalent.
Attribute
Type
Description
start
String
String with an iCalendar DATETIME value
duration
String
String with an iCalendar
DURATION value
recurrence
String
String with a RECUR rule
Extended Attribute
Each extended attribute object has at least the following properties:
Attribute
Type
Description
text
label
String
extended attribute
via
174
► API Reference
Attribute
Type
Description
attribution
Phonetic Place Information
A structure for holding phonetic information for a place.
For each field there might be multiple phonemes provided. If there are multiple phonemes the ones
which match the users language preference best are returned first.
Attribute
Type
Description
title
Array[Phoneme]; optional
Phonetic transcription of the
place title.
address
Object[AddressPhonemes];
Phonetic transcription of the
optional
address information..
Attribute
Type
Description
value
String
The actual phoneme
language
String[language tag]
the ISO language code
Phonetic Transcription
A phonetic transcription.
Phonetic Address
A structure to hold phonetic information for an address.
Attribute
Type
Description
street
Street name
district
A division of city; typically an
administrative unit within a
175
► API Reference
Attribute
Type
Description
larger city or a customary name
of a city's neighborhood.
city
The name of the primary locality
of the place.
regions
Array[Array[Phoneme]]; optional For address conventions where
more than to levels of named
areas above the city level are
in use, the regions attribute
provides an array with all
additional area names, ordered
by decreasing size (starting with
the highest subdivision below
state)
county
A division of a state; typically a
secondary-level administrative
division of a country or
equivalent.
state
A division of a country; typically
a first-level administrative
division of a country and/or a
geographical region.
country
The country name.
Search Link
A link to a further search query based on the current search query. It may contain, for example,
results restricted to a certain category or results for a suggested alternative search term.
This is an example of a result item representing a further search within a specified category:
{
"href": "http://...",
}
176
► API Reference
This is an example of a result item representing an alternative suggestion for a search term:
{
"title": "Hotel Adlon",
"icon": "http://...",
"href": "http://.../discover/search?at=52.53044,13.41112&q=Hotel+Adlon",
"vicinity": "Berlin Germany",
"modified": true
}
Attribute
Type
Description
title
String
this element.
icon
String (URI)
The URI of an iconic
representation of the item.
type
String; optional
href
String (URI)
A hyperlink that refers to place
discovery restricted by certain
group (e.g. category).
categoryId
String; optional
A unique category identifier.
vicinity
place is located.
177
► API Reference
Result Display
The result items are ordered by relevance criteria that are appropriate in the context of a given
discovery resource. Applications presenting the result to their users should take care to reflect that
order in the way they display the results and should direct a user's attention to the first result items
first.
Client applications might want to display different types of result items in different ways. This
might imply that the application cannot reflect the global order of all result items. Still it is highly
recommended that the absolute first result item is the one first displayed to the user and that the
application reflects the relative order of items within each type.
User Object Structure
User objects contain additional attributes to describe a user.
Since a user object contains an href attribute, it is also a link object. This object contains the
following attributes:
Attribute
Type
Description
id
String; optional
id
name
String
username
href
A hyperlink to user's profile.
icon
A hyperlink to user's avatar.
type
String; optional
The MIME media type of the
user's profile.
Media Collection
A media collection object provides access to additional content for a place.
All media properties are paginateable collections. When a given media collection is not available for a
place, the attribute for that collection is not present.
Some media elements might support additional features, in which case individual media elements are
also link-objects pointing to a full media resource with hyperlinks for the available features.
178
► API Reference
Attribute
Type
Description
available
Number (integer)
The total number of items
available for a place, i.e. this
would be 50 for a place with 50
images.
Note: It is not possible
to always calculate
the total number of
elements in a collection.
So the attribute might
be missing, or just
contain an estimate.
Clients MUST not
rely on the presence
of the attribute but
instead rely only on the
existence of the next
attribute to find out
if additional items are
available.
offset
Number (positive integer);
Pages other than the first page
optional
of a collection may include this
attribute. If present, it contains
the index of the first item in the
current page.
previous
holding the previous page of the
the first page of the collection,
next
holding the next page of the
179
► API Reference
Attribute
Type
Description
the last page of the collection,
items
Array[ActionLink | PlaceArticle
An array containing the objects
| PlaceEditorial | PlaceImage
of the current page of the
| PlaceRatingsSummary |
collection (eg. images). If a
PlaceReview]
collection is empty, the items
attribute is not present. The
type of the objects in the array
depend on the collection. It may
be for example Editorial Items or
Review Items
Action Link
This object represents a link to a Uri for interacting with a place, for example booking a table at a
restaurant.
Attribute
Type
Description
id
String; optional
Identifier of the link
url
String (URI)
The URI of the link.
title
String
The title of the link
supplier
Object[Link]
supplier of the link. The object
icon.
PlaceEditorial
A Place Editorial object provides access to editorial descriptions about the place.
180
► API Reference
Attribute
Type
Description
description
The editorial content.
language
String (RFC 5646 language tag); A language code indicating what
optional
language the review is in, if
known.
via
supplier
attribution
PlaceImage
A Place Image object provides access to an image attached to the place.
Attribute
Type
Description
src
String (URI)
A URL to the actual image
id
String; optional
Identifier of image if uploaded
via Places (Search) API (this ID is
returned from an image upload
response)
href
image object of this item.
type
String; optional
date
The date the image was
optional
uploaded.
A map containing links to the
optional
sized variants of the original
dimensions
image.
user
contributed the image.
title
String; optional
A localized title to be displayed
for this element
181
► API Reference
Attribute
Type
via
supplier
attribution
Description
PlaceReview
A Place Review object provides access to review and ratings given by other users.
Attribute
Type
Description
id
String; optional
Identifier of review if uploaded
via Places (Search) API (this
ID is returned from a review
uploaded response).
href
review object of this item.
type
String; optional
date
The review date
optional
title
String; optional
The title the user gave to the
review.
rating
Number; optional
The rating that the writer of the
review gave to the place. Note:
Ratings may come from various
systems with different rating
schemes. The value of that
attribute may not reflect the
rating scheme of the supplier's
service, but is adjusted to
the value range of the Places
(Search) API (1..5).
182
► API Reference
Attribute
Type
Description
description
The review content. Depending
on the supplier it might not
display the full content and the
full review is only available on
the resource linked by the via
property.
user
contributed the review.
language
String (RFC 5646 language tag); A language code indicating what
optional
language the review is in, if
known
via
supplier
attribution
Object Structure For Paginateable Collections
Paginateable Collections
User objects contain additional attributes to describe a user.
Paginateble collections are represented as individual pages (a slice of all elements of the collection)
that contain mechanisms to access the next page. For example:
{
"available": 26,
"next": "http://alphabet.com/page/3",
"offset": 3,
"items": ["d", "e", "f"]
}
Paginateble collections contain the following attributes:
Attribute
Type
Description
items
Array[Object]; optional
An array containing the objects of the current
page of the collection (for example, images). If
a collection is empty, the items attribute is not
183
► API Reference
Attribute
Type
Description
present. The type of the objects in the array depend
on the collection.
next
String (URI); optional)
The URI to the subresource holding the next page of
the collection. If the current page is the last page of
the collection, the attribute is not present.
available
The total number of items available for a place. For
optional
example, if a place has 50 images, this would be 50.
Note: It is not possible to always calculate
the total number of elements in a
collection. So the attribute might be
missing, or just contain an estimate.
Clients MUST not rely on the presence of
the attribute but instead rely only on the
existence of the next attribute to find out
if additional items are available.
offset
Pages other than the first page of a collection may
optional
include this attribute. If present, it contains the
index of the first item in the current page.
Address Object Structure
Address information is provided in two ways: as a displayable, formatted address string as well as a
series of structured attributes.
{
"address": {
"street": "22 Rue du Grenier Saint-Lazare",
"city": "Paris",
"countryCode": "FRA",
"text": "22 Rue du Grenier Saint-Lazare\n75003 Paris\nFrance"
}
}
The address object contains the following attributes:
Attribute
Type
Description
text
A displayable, formatted
address as rich text.
level
String; optional
Contains level of place inside of
a venue
184
► API Reference
Attribute
Type
Description
building
String; optional
Building name
house
String; optional
House or street number.
street
String; optional
Street name (in practice may
also contain street number).
postalCode
String; optional
An alphanumeric string included
in a postal address to facilitate
mail sorting (a.k.a. post code,
postcode, or ZIP code).
areas
An array of named areas below
the district and above street. In
some regions such areas might
also contain street names, when
individual street segments have
names separate from the name
of the whole road.
district
String; optional
A division of city; typically an
administrative unit within a
larger city or a customary name
of a city's neighborhood.
city
String; optional
The name of the primary locality
of the place.
regions
For address conventions where
more than to levels of named
areas above the city level are
in use, the regions attribute
provides an array with all
additional area names, ordered
by decreasing size (starting with
the highest subdivision below
state)
county
String; optional
A division of a state; typically a
secondary-level administrative
185
► API Reference
Attribute
Type
Description
division of a country or
equivalent.
state
String; optional
A division of a country; typically
a first-level administrative
division of a country and/or a
geographical region.
stateCode
String; optional
A code/abbreviation for the
state division of a country.
country
String; optional
The localised country name.
countryCode
String (ISO 3166-1 alpha-3
A three-letter country code.
code); optional
Alternative Name
Each alternative name is an object providing an alternative name for a place as well as information on
the language of that name.
Attribute
Type
Description
name
String
The alternative name.
language
String (language tag)
The language/locale of the name.
Note: A place only contains those alternative names that match the client's language
preferences, plus the locally used name of the place (if this differs from the base name).
Contacts Object Structure
There are multiple mechanisms for contacting a place. For each available type of contact, the object
contains an attribute that provides a list of contact details for that type. The possible types include:
Attribute
Type
Description
phone
Array[LabeledValue]; optional
A telephone number for voice
calls
186
► API Reference
Attribute
Type
Description
fax
A telephone number
for facsimile (telecopy)
transmissions
email
An e-mail address for sending
messages to the place
website
A URL for the website operated
by the place
New types may be added at any time and client applications should iterate over all available contact
types instead of just using this predefined set, to ensure that they always display all available contact
mechanisms to their users.
The contacts within a type are ordered by relevance. So clients that are only capable of displaying a
single contact per type should always display the first entry. But in general, client applications should
iterate over all contacts and use the label assigned to the contacts to distinguish them.
When there are many items of the same type, these items can be combined. Two phone items, for
example, can be displayed as shown below:
An example of multiple phone objects could be:
"contacts": {
"phone": [
{
"label": "Phone",
"value": "+33147206252"
},
{
"label": "Mobile",
"value": "+33147206252"
}
],
...
}
Labeled Value
Each individual contact item provides two attributes:
Attribute
Type
Description
value
String
A localized label to describe the
purpose of the contact.
187
► API Reference
Attribute
Type
Description
label
String
A string value appropriate for
the contact method.
Error Object Structure
The error object contains information on an error that occurred when the user tried to request a
resource. For example:
{
"status": 401,
"message": "Missing authentication parameters"
}
A more detailed example:
The error object has the following attributes:
Attribute
Type
Description
status
Number (integer)
The HTTP response status code
of the request
message
String
The message relating to the
most important error to show to
the user.
incidentId
String; optional
Unique incident identifier.
errCode
String; optional
The error code relating to the
most important error to show to
the user.
details
An object containing error
Array[SubError]); optional
details relating to the request.
Response Status Codes
400 Bad Request
The request can not be fulfilled because the request contained bad syntax
or didn't contain required parameter or header.
401 Unauthorized
The client needs to authenticate in order to access the resource. Bearer
token header, app_id or app_code are missing, empty or invalid.
188
► API Reference
403 Forbidden
The client is not allowed to access this resource for some reasons.
404 Not Found
Requested resource was not found, though its existence in the future is
possible.
405 Method Not
The method used in the request is not supported by the resource.
Allowed
406 Not Accepted
The server can not generate content which is acceptable to the client
according to the request's Accept header.
408 Request
The client did not complete its request in a reasonable timeframe.
Timeout
410 Gone
The resource is gone and will always be gone; the client should not request
the resource again.
415 Unsupported
The server can not process the request body because it is of an
Media Type
unsupported MIME type. Please refer to HTTP Request Headers on page
65 for details.
429 Too Many
Request quota has been exceeded. Please contact [email protected] to
Requests
upgrade your plan.
500 Internal
The server encountered an unexpected condition which prevented it from
Server Error
fulfilling the request.
501 Not
The server can not process the request method
Implemented
503 Service
The resource is temporarily unavailable.
Unavailable
Important: In case you receive an error message informing you that your credentials
(app_id and app_code) do not grant you access to a specified feature, contact your HERE
representative.
SubError
Error detail item object.
Attribute
Type
Description
message
String
The error message
189
► API Reference
Attribute
Type
Description
errCode
String
The error code
Location Object Structure
A location object contains attributes to describe the physical location of a place. The attributes
are:
Attribute
Type
Description
position
Array[Number]
A position indicated by latitude and longitude, for
example [37.785141,-122.4047775].
address
Object[address]; optional
An object containing the street address of the place.
Some places may not have an address (for example,
a mountain).
locationId
String; optional
A unique identifier of the location when assigned.
Rating Object Structure
Provides a summary of how users rated a place.
Attribute
Type
Description
average
Number (double)
The average rating across all users.
count
Number (positive integer)
The number of individual votes on the place.
Place without Ratings
Note: If the place has no ratings (yet), both the average and the count values are zero. But
if the place cannot be rated (i.e. a street), the whole rating object is not present.
HTTP Status Codes
Places (Search) API supports the standard HTTP status codes
Status code
Description
200 OK
Indicates success.
201 Created
Indicates success.
190
► API Reference
Status code
Description
400 Bad request
Invalid parameter value in the request, for example zoom out of range.
401 Unauthorized
Invalid authentication.
403 Forbidden
Incorrect app_code or app_id in the request. See Acquiring Credentials on page 27 for
more information.
404 Not found
Unsupported parameter in the request.
410 Gone
The requested resource is no longer available, for example a place that has been removed
from the system.
429 Too Many Requests
The user has sent too many requests in a given amount of time or user's request quota has
been exceeded.
500 Internal error
There is a server configuration issue.
503 Service Unavailable
Indicates that the service is temporarily unavailable due to system overload or maintenance.
Supported Chain and Category Query Terms
This section provides lists of supported category-like and chain-like query terms.
List of Supported English (UK) Category-like Query
Terms
Query Term
Category
erotic
adult-entertainment
erotic shops
adult-shop
erotic
adult-shop
erotic shop
adult-shop
african cuisine
african
african food
african
ambulance services
ambulance-services
american food
american
cuisine of the united states
american
american cuisine
american
aparment
apartment-rental-flat-rental
191
► API Reference
Query Term
Category
appartment
public aquarium
aquarium
public aquariums
aquarium
drink link
atm
automated teller machines
atm
cash dispensers
atm
cash dispenser
atm
cashomats
atm
automated teller machine
atm
cashomat
atm
drink links
atm
law firms
attorney
law offices
attorney
austrian food
austrian
austrian cuisine
austrian
automobile dealerships new car
automobile-dealership-new-cars
automobile dealerships new cars
motor cos
motor companies
showrooms
showroom
used cars dealership
automobile-dealership-used-cars
dealers used car
used car dealership
dealers used cars
used autos
dealerships used cars
used auto
automobile dealerships used cars
dealerships used car
192
► API Reference
Query Term
Category
used automobile
used car dealerships
used cars dealerships
dealership used cars
used automobiles
dealership used car
beer joint
bar-pub
bar and pub
bar-pub
beer joints
bar-pub
bars and pubs
bar-pub
belgian cuisine
belgian
belgian food
belgian
bicycles
bicycle
bike
bicycle
bikes
bicycle
bicycle
bicycle
bicycle dealers
bicycle-and-bicycle-accessories-shop
bicycle dealer
bike dealer
bike dealers
bicycle repair shop
bicycle-service-and-maintenance
bike repair shops
bicycle repair shops
bike repair shop
billiards and pool halls
billiards-pool-hall
billiards bars
billiards-pool-hall
billiards and pool hall
billiards-pool-hall
billiards bar
billiards-pool-hall
british cuisine
british
bus & coach station
bus-terminal
193
► API Reference
Query Term
Category
coach stations
bus-terminal
bus lines
bus-terminal
bus and coach station
bus-terminal
bus depot
bus-terminal
bus stands
bus-terminal
coach station
bus-terminal
bus and coach stations
bus-terminal
bus stand
bus-terminal
canadian cuisine
canadian
canadian
canadian
canadian restaurant
canadian
canadian food
canadian
canadian restaurants
canadian
automotive parts & accessories
car-parts-and-accessories
car parts and accessories
automotive parts and accessories
auto parts and accessories
auto parts & accessories
car agency
car-rental
rent a car agencies
car-rental
rent a cars
car-rental
car agencies
car-rental
car hires
car-rental
rental car agency
car-rental
rent a car
car-rental
rent a car agency
car-rental
rental car agencies
car-rental
mechanic shop
car-repair
mechanics service
car-repair
car repair services
car-repair
194
► API Reference
Query Term
Category
mechanic service
car-repair
mechanic services
car-repair
mechanics shops
car-repair
mechanics services
car-repair
mechanics shop
car-repair
mechanic shops
car-repair
car repair service
car-repair
wash centres
car-wash-detailing
wash centre
car-wash-detailing
car care
car-wash-detailing
cargo centre
cargo-center
cargo centres
cargo-center
lotteries
casino
lottery
casino
gaming
casino
children's clothing
childrens-apparel
children's apparel
childrens-apparel
children's apparels
childrens-apparel
children's museum
childrens-museum
children's museums
childrens-museum
chines restaurant
chinese
chines restaurants
chinese
chines
chinese
boutiques
clothing-accessories-shop
fashion
clothing and accessories
fashions
clothing and accessory
caffes
coffee
espressos
coffee
195
► API Reference
Query Term
Category
espresso cafes
coffee
caffs
coffee
expressos
coffee
caff
coffee
coffees and teas
coffee-tea
coffee and tea
coffee-tea
commuter trains
commuter-rail-station
construction businesses
construction
construction company
construction
construction companies
construction
construction business
construction
customer care service centres
customer-care-service-center
customer care service centre
customer-care-service-center
dental surgeon
dentist
dental surgereons
dentist
dept stores
department-store
dept store
department-store
general practitioner
doctor
family doctors
doctor
general practitioners
doctor
gps
doctor
gp
doctor
dutch
dutch
dutch food
dutch
dutch restaurant
dutch
dutch cuisine
dutch
dutch restaurants
dutch
eat&drink
eat-drink
consulates and embassies
embassy-consulate
entertainment electronic
entertainment-electronics
196
► API Reference
Query Term
Category
convention ctr
fair-convention-facility
expo and convention facility
fair and convention facility
ferry station
ferry-terminal
gourmet restaurant
fine-dining
fine dining places
fine-dining
fine dining restaurant
fine-dining
fine dining place
fine-dining
fine dining restaurants
fine-dining
gourmet restaurants
fine-dining
training centre
fitness-health-club
training centres
fitness-health-club
fitness centres
fitness-health-club
fitness centre
fitness-health-club
food
food
foods
food
food and drink
food-drink
french restaurants
french
french food
french
french cuisine
french
french
french
french restaurant
french
fine arts
gallery
garden centre
garden-center
garden centres
garden-center
german food
german
german cuisine
german
german restaurants
german
german restaurant
german
german
german
197
► API Reference
Query Term
Category
night out
going-out
go out
going-out
nights out
going-out
go out at night
going-out
going out at night
going-out
on the town
going-out
groceries shop
grocery
groceries shops
grocery
groceries store
grocery
groceries stores
grocery
hair
hair-workaround
house and garden
hardware-house-garden-shop
hard ware house and garden
hardware house and garden
hawaiian restaurant
hawaiian-polynesian
hawaiian restaurants
hawaiian-polynesian
historic monuments
historical-monument
historic monument
historical-monument
diy store
home-improvement-hardware-store
diy shops
diy shop
diy stores
casualty hospital
hospital
casualty hospitals
hospital
hospital and health care
hospital and healthcare
hungarian cuisine
hungarian
hungarian food
hungarian
indoor sport
indoor-sports
industrial estate
industrial-area
198
► API Reference
Query Term
Category
intl air ports
international-airport
intl air port
int air ports
intl airports
int airport
international airports
international airport
international air ports
intl airport
int airports
international air port
int air port
japanesr restaurants
japanese
japanesr
japanese
japanesr cuisine
japanese
restaurants japanese
japanese
japanesr food
japanese
japanesr restaurant
japanese
restaurant japanese
japanese
daycare centres
kindergarten
daycare centre
kindergarten
sight
landmark-attraction
sights
landmark-attraction
leisure and outdoor
leisure-outdoor
leisure and outdoors
leisure-outdoor
public community library
library
public community libraries
library
major appliance shop
major-appliance
major appliances store
major-appliance
major appliance stores
major-appliance
199
► API Reference
Query Term
Category
major appliance store
major-appliance
major appliances shop
major-appliance
major appliances shops
major-appliance
major appliances stores
major-appliance
major appliance shops
major-appliance
maltese cuisine
maltese
maltese food
maltese
men's fashion shops
mens-apparel
men's apparel stores
mens-apparel
men's clothes shops
mens-apparel
men's fashion store
mens-apparel
men's fashion
mens-apparel
men's clothes stores
mens-apparel
men's apparel store
mens-apparel
men's apparel shops
mens-apparel
men's apparel
mens-apparel
men's clothes shop
mens-apparel
men's fashion stores
mens-apparel
men's apparel shop
mens-apparel
men's clothes
mens-apparel
men's fashion shop
mens-apparel
men's clothes store
mens-apparel
modeling agency
modeling-agencies
film
movie
movie
movie
films
movie
motion pictures
movie
motion picture
movie
movies
movie
music
music-workaround
200
► API Reference
Query Term
Category
natural and geographical
natural-geographical
discos
night-club
disco
night-club
recreation centres
park-recreation-area
recreation centre
car park
parking-facility
parking facilities
parking-facility
car parking
parking-facility
parking lots
parking-facility
car parks
parking-facility
fuel stations
petrol-station
petrol pumps
petrol-station
gas bars
petrol-station
gas bar
petrol-station
fueling station
petrol-station
petrol pump
petrol-station
fuel station
petrol-station
fueling stations
petrol-station
chemist's shop
pharmacy
chemist's shops
pharmacy
chemist's
pharmacy
dispensary
pharmacy
dispensaries
pharmacy
pizza shops
pizza
pizza shop
pizza
polish cuisine
polish
polish food
polish
portuguese food
portuguese
portuguese cuisine
portuguese
sport airports
public-sports-airport
201
► API Reference
Query Term
Category
sports airports
sports airport
sport airport
public transit
public-transport
restrants
restaurant
reastrant
restaurant
restaurent
restaurant
restaurents
restaurant
resurant
restaurant
resurants
restaurant
russian cuisine
russian
russian food
russian
go shopping
shopping
sights and museums
sights-museums
ski area
ski-resort
snack bar
snacks-fast-food
snack bars
snacks-fast-food
snackbar
snacks-fast-food
snackbars
snacks-fast-food
spanish cuisine
spanish
spanish restaurant
spanish
spanish food
spanish
spanish
spanish
spanish restaurants
spanish
specialty clothing shops
specialty-clothing-store
specialty clothing shop
specialty clothes
specialty clothing
specialty food shop
specialty-food-store
specialty foods
202
► API Reference
Query Term
Category
specialty food shops
specialty food
specialty shop
specialty-store
specialty shops
specialty-store
sporting goods
sport-outdoor-shop
sports equipment
sport-outdoor-shop
sports and outdoor
sport-outdoor-shop
sport activity
sports-activities
sport activities
sports-activities
sport facility
sports-facility-venue
sports facilities and venues
sport fields
sports-field
sport field
sports-field
super market
supermarket
super markets
supermarket
supermarket
supermarket
supermarkets
supermarket
surinamese cuisine
surinamese
surinamese food
surinamese
sushi bar
sushi
sushi bars
sushi
sushi restaurant
sushi
sushi
sushi
sushi restaurants
sushi
swiss
swiss
swiss cuisine
swiss
swiss restaurant
swiss
swiss food
swiss
swiss restaurants
swiss
seamstresses
tailor-and-alteration
203
► API Reference
Query Term
Category
spanish tapa
tapas
spanish tapas
tapas
spanish tapasbars
tapas
spanish tapas restaurants
tapas
spanish tapas bar
tapas
spanish tapas bars
tapas
spanish tapas restaurant
tapas
spanish tapasbar
tapas
tacos
taqueria
taco
taqueria
cabs
taxi
taxis
taxi
cab
taxi
taxi
taxi
taxicab stand
taxi-stand
taxicab ranks
taxi-stand
taxicab rank
taxi-stand
taxicab stands
taxi-stand
teaparlors
tea
tea parlours
tea
teaparlours
tea
tea parlors
tea
theater music and culture
theatre-music-culture
theatre music and culture
theatre-music-culture
tyre shop
tires
wheel tyres
tires
tyre shops
tires
tyre sales
tires
wheel tyre
tires
tyreshop
tires
204
► API Reference
Query Term
Category
tyre service
tires
auto tyre
tires
tyres
tires
tyre auto
tires
tyreshops
tires
tyrestores
tires
tyre store
tires
tyre
tires
auto tyres
tires
wheels tyres
tires
tyrestore
tires
tyre discount
tires
tyre repair
tires
tyre services
tires
tyres auto
tires
tyre stores
tires
tyre repairs
tires
tyre sale
tires
wheels tyre
tires
tyre wheels
tires
tyre discounts
tires
tyres wheel
tires
tyres wheels
tires
tyre wheel
tires
transportation
transport
transportations
transport
travel services
travel-agency
travel service
travel-agency
turkish food
turkish
turkish cuisine
turkish
205
► API Reference
Query Term
Category
tube
underground-station
tube station
underground-station
tube stations
underground-station
vegan
vegan
vegan restaurants
vegan
vegan places
vegan
vegan cuisine
vegan
vegan restaurant
vegan
vegan place
vegan
vegan food
vegan
booze
wine-and-liquor
booze stores
wine-and-liquor
booze store
wine-and-liquor
offies
wine-and-liquor
booze shop
wine-and-liquor
wine & spirits
wine-and-liquor
booze shops
wine-and-liquor
offie
wine-and-liquor
women's apparel store
womens-apparel
women's apparel shops
womens-apparel
women's fashion store
womens-apparel
women's clothes store
womens-apparel
women's fashion
womens-apparel
women's clothes shop
womens-apparel
women's apparel stores
womens-apparel
women's apparel shop
womens-apparel
women's clothes stores
womens-apparel
women's clothes shops
womens-apparel
women's fashion shop
womens-apparel
women's apparel
womens-apparel
206
► API Reference
Query Term
Category
women's fashion stores
womens-apparel
women's fashion shops
womens-apparel
women's clothes
womens-apparel
zoological parks
zoo
zoological garden
zoo
zoological gardens
zoo
zoological park
zoo
List of Supported French Category-like Query Terms
Query Term
Category
divertissements pour adultes
adult-entertainment
divertissement pour adultes
adult-entertainment
divertissement adultes
adult-entertainment
divertissements adultes
adult-entertainment
animations adultes
adult-entertainment
vidéo pornographique
adult-shop
videos erotiques
adult-shop
video porno
adult-shop
boutique erotique
adult-shop
videos pour adultes
adult-shop
vidéos érotique
adult-shop
video pour adultes
adult-shop
boutique érotique
adult-shop
vidéo porno
adult-shop
video erotiques
adult-shop
vidéo pour adultes
adult-shop
vidéo érotique
adult-shop
vidéo érotiques
adult-shop
boutiques érotique
adult-shop
boutique érotiques
adult-shop
207
► API Reference
Query Term
Category
vidéos pornographiques
adult-shop
boutique erotiques
adult-shop
video pornographiques
adult-shop
boutiques erotique
adult-shop
boutiques erotiques
adult-shop
videos porno
adult-shop
video erotique
adult-shop
boutiques érotiques
adult-shop
vidéos porno
adult-shop
videos pornographiques
adult-shop
vidéos pornographique
adult-shop
vidéos pour adultes
adult-shop
vidéo pornographiques
adult-shop
video pornographique
adult-shop
videos pornographique
adult-shop
videos erotique
adult-shop
vidéos érotiques
adult-shop
agence de publicite
advertising-marketing-pr-and-market-research
agences marketing
agences publicité
agences pub
societe de marketing
societes publicite
sociétés marketing
societes de publicite
sociétés de marketing
societes pub
agence publicité
publicité
societes de pub
208
► API Reference
Query Term
Category
sociétés pub
société de publicité
societes de marketing
agence de pub
societe de pub
sociétés publicité
societes marketing
agence publicite
agence pub
agences de pub
agence de publicité
societe publicite
agence marketing
société publicité
societe de publicite
publicite
société de pub
sociétés de publicité
sociétés de pub
societe pub
société pub
société de marketing
agences de publicite
societe marketing
agence de marketing
agences de marketing
agences publicite
agences de publicité
société marketing
téléphériques
aerial-tramway
209
► API Reference
Query Term
Category
téléfériques
aerial-tramway
telepherique
aerial-tramway
teleferiques
aerial-tramway
telepheriques
aerial-tramway
teleferique
aerial-tramway
téléférique
aerial-tramway
téléphérique
aerial-tramway
cuisine africaine
african
fret de l'aéroport
airport-cargo
fret de l'aeroport
airport-cargo
services médicaux d'urgence
ambulance-services
services medicaux d'urgence
ambulance-services
services d’urgences médicales
ambulance-services
services d’urgences medicales
ambulance-services
services ambulanciers
ambulance-services
service d’urgences medicales
ambulance-services
ambulances
ambulance-services
service d’urgences médicales
ambulance-services
cuisine des états unis
american
cuisine des etats unis
american
salle d'arcade
amusement-arcade
parc d'attractions ou camp de vacances
amusement-holiday-park
parc d'attractions ou de vacances
amusement-holiday-park
parc d'attractions
amusement-park
parcs d'attractions
amusement-park
parc thematiques
amusement-park
parcs thématiques
amusement-park
parcs thematique
amusement-park
parc thématique
amusement-park
parc thématiques
amusement-park
210
► API Reference
Query Term
Category
parcs thematiques
amusement-park
parcs d’attractions
amusement-park
parcs thématique
amusement-park
parc thematique
amusement-park
parc d’attractions
amusement-park
parcs animaliers
animal-park
parc animalier
animal-park
location appartements
appartements
appartement
location appartement
location d'appartements
aquariums
aquarium
aquarium
aquarium
aquarium public
aquarium
musee d'art
art-museum
musees d'art
art-museum
musées d'art
art-museum
musée d'art
art-museum
magasin de loisirs créatifs
arts-and-crafts-supplies
magasins d'artisanat
boutique de loisirs creatifs
boutiques fournitures d'artisanat
magasins de loisirs creatifs
boutiques loisirs créatifs
approvisionnement en metiers d'art
magasins de loisirs créatifs
boutique de loisirs créatifs
boutique loisirs creatifs
boutiques de fournitures d'artisanat
211
► API Reference
Query Term
Category
magasins loisirs créatifs
magasins fournitures d'artisanat
magasin d'artisanat
approvisionnement en métiers d'art
metiers d'art
magasin loisirs creatifs
magasins de fournitures d'artisanat
magasins loisirs creatifs
boutiques de loisirs créatifs
métiers d'art
boutiques d'artisanat
boutique de fournitures d'artisanat
magasin de loisirs creatifs
magasin de fournitures d'artisanat
magasin loisirs créatifs
boutique d'artisanat
artisanat
boutiques loisirs creatifs
fournitures d'artisanat
boutique loisirs créatifs
boutiques de loisirs creatifs
boutique fournitures d'artisanat
magasin fournitures d'artisanat
centre d'arts
arts-centre
bancomats
atm
gabs
atm
guichets automatiques bancaires
atm
distribanques
atm
distributeur de billets banque envoi d'argent
atm-bank-exchange
avocats
attorney
212
► API Reference
Query Term
Category
avocat
attorney
cabinets d'avocats
attorney
procureurs
attorney
procureur
attorney
cabinet d'avocats
attorney
cuisine autrichienne
austrian
concessionaire d'automobiles
concessionaires d'automobiles
concessionnaire de voitures d'occasion
concessionnaires d'automobile voiture d'occasion
concessionnaires de voiture d'occasion
voitures d'occasion
garage de voiture d'occasion
voiture d'occasion
concessionnaire d'automobile voiture d'occasion
concessionnaire de voiture d'occasion
concessionnaires de voitures d'occasion
garages de voiture d'occasion
salles badminton
badminton
court de badminton
badminton
salle de badminton
badminton
terrains de badminton
badminton
terrain badminton
badminton
salles de badminton
badminton
courts badminton
badminton
terrains badminton
badminton
courts de badminton
badminton
terrain de badminton
badminton
court badminton
badminton
salle badminton
badminton
213
► API Reference
Query Term
Category
salle de banquet
banquet-hall
salles de banquet
banquet-hall
terrain de basket
basketball
terrains de basket
basketball
terrain de basket ball
basketball
terrains de basket ball
basketball
terrains basket
basketball
parcs de basket
basketball
parcs basket ball
basketball
parc basket
basketball
parc de basket ball
basketball
terrains basket ball
basketball
parc basket ball
basketball
parcs basket
basketball
parc de basket
basketball
terrain basket
basketball
terrain basket ball
basketball
parcs de basket ball
basketball
plages
beach
plage
beach
chambres d'hotes
bed-and-breakfast
chambres d'hôtes
bed-and-breakfast
gites touristique
bed-and-breakfast
chambre d'hotes
bed-and-breakfast
gite touristique
bed-and-breakfast
gîtes touristique
bed-and-breakfast
chambre d'hôtes
bed-and-breakfast
gîte touristique
bed-and-breakfast
velos
bicycle
cycles
bicycle
214
► API Reference
Query Term
Category
vélos
bicycle
cycle
bicycle
bicyclette
bicycle
vélo
bicycle
bicyclettes
bicycle
velo
bicycle
velos
vélos
magasins de vélo
magasins de velo
vélo
magasin velo
magasin de velo
magasin de vélo
magasins vélo
velo
magasin vélo
magasins velo
réparations cycles
reparations de bicyclette
réparation de cycles
atelier de réparation vélo
ateliers de réparations cycles
reparations velos
reparation de velo
reparateur reparations de velos
ateliers de réparation cycle
ateliers de reparation de velos
mécanicien réparation bicyclettes
réparateur réparation de bicyclettes
215
► API Reference
Query Term
Category
reparateur reparation velos
atelier de réparation de bicyclettes
réparateur réparations de bicyclettes
ateliers de reparations velos
ateliers de reparation de velo
mécanicien réparation vélo
réparation bicyclettes
mécanicien réparations de cycles
atelier de reparations cycles
ateliers de reparations de bicyclette
reparations de bicyclettes
atelier de réparation bicyclettes
atelier de reparation cycle
ateliers de reparations cycle
atelier de réparation bicyclette
maintenances et service vélos
reparations de velo
ateliers de réparation de cycles
atelier de réparations de bicyclette
reparateur reparations de bicyclette
ateliers de réparations de cycles
reparation de velos
atelier de réparations de vélo
réparateur réparation vélo
reparation bicyclettes
reparations cycle
atelier de reparation de velo
ateliers de reparations bicyclette
ateliers de reparation cycles
réparateur réparations bicyclette
216
► API Reference
Query Term
Category
réparations cycle
ateliers de réparation de bicyclettes
reparation de cycles
atelier de réparations vélos
ateliers de réparations bicyclettes
reparateur reparation de cycles
atelier de reparation de cycle
reparation cycles
réparateur réparations de cycles
réparations bicyclette
mécanicien réparation de vélos
réparation de vélo
mécanicien réparations de vélos
ateliers de réparation de cycle
reparateur reparations velos
reparations cycles
atelier de réparation cycles
atelier de reparation velos
reparateur reparation velo
ateliers de reparations velo
réparations de vélo
ateliers de réparation bicyclette
reparateur reparations de cycles
mécanicien réparations vélos
atelier de réparation de vélos
mécanicien réparation cycles
reparation velos
reparateur reparations de cycle
atelier de reparations bicyclettes
mecanicien reparations cycle
217
► API Reference
Query Term
Category
ateliers de réparation bicyclettes
reparateur reparation de velos
maintenance et entretien de vélo
ateliers de reparations de velos
ateliers de reparations de bicyclettes
atelier de reparations de bicyclette
mecanicien reparations velos
reparations velo
ateliers de réparation vélo
atelier de réparation de cycle
ateliers de reparation de bicyclette
ateliers de réparations vélo
atelier de reparation de cycles
mécanicien réparations de bicyclettes
réparations de bicyclettes
ateliers de réparations bicyclette
atelier de réparations bicyclette
mecanicien reparation de cycle
mecanicien reparation velos
atelier de reparation bicyclettes
ateliers de réparations de vélo
réparateur réparations vélo
réparations de bicyclette
reparateur reparation bicyclettes
atelier de réparations cycle
réparations vélos
réparation vélos
mécanicien réparations de bicyclette
reparations de cycle
réparateur réparations vélos
218
► API Reference
Query Term
Category
réparation de bicyclette
reparateur reparation cycles
atelier de réparations de vélos
atelier de réparation de bicyclette
reparation cycle
atelier de réparations bicyclettes
réparateur réparation bicyclettes
réparations vélo
reparateur reparations cycle
atelier de reparations de velos
ateliers de reparations bicyclettes
atelier de reparations de bicyclettes
mecanicien reparations de cycles
mecanicien reparations bicyclette
reparation de bicyclettes
réparation de cycle
mécanicien réparations de vélo
atelier de reparation bicyclette
reparateur reparation de cycle
atelier de réparation de vélo
réparateur réparation de vélos
reparation de bicyclette
reparations bicyclettes
reparateur reparation bicyclette
reparation bicyclette
mecanicien reparation cycles
atelier de reparations de cycles
reparateur reparation de bicyclettes
mecanicien reparations de velos
atelier de reparation velo
219
► API Reference
Query Term
Category
ateliers de réparations cycle
réparateur réparations de vélo
reparateur reparations de velo
atelier de réparation de cycles
mecanicien reparation cycle
réparateur réparations cycles
mecanicien reparations velo
réparation vélo
ateliers de réparations de cycle
ateliers de reparation bicyclette
reparateur reparation cycle
réparateur réparations cycle
ateliers de reparation de bicyclettes
mécanicien réparations cycle
ateliers de réparation vélos
maintenances et service velos
mecanicien reparations de velo
mecanicien reparations de bicyclettes
reparateur reparations bicyclettes
ateliers de reparation de cycles
reparations de cycles
ateliers de réparations de vélos
ateliers de reparation de cycle
ateliers de reparation cycle
réparations bicyclettes
atelier de réparations de cycles
mecanicien reparations de bicyclette
mecanicien reparation de cycles
réparation bicyclette
réparation de bicyclettes
220
► API Reference
Query Term
Category
atelier de réparation cycle
atelier de reparations velos
atelier de reparations bicyclette
réparations de vélos
atelier de réparation vélos
ateliers de reparations cycles
ateliers de reparation bicyclettes
mecanicien reparations bicyclettes
réparation cycles
mécanicien réparations vélo
réparateur réparation cycle
mécanicien réparation de bicyclettes
reparations bicyclette
reparateur reparations velo
réparateur réparation de vélo
ateliers de reparations de cycle
mécanicien réparations bicyclette
réparation de vélos
atelier de reparation cycles
ateliers de reparation velos
réparations de cycles
réparateur réparation bicyclette
ateliers de réparations de bicyclette
maintenance et entretien de velo
reparateur reparations bicyclette
reparation velo
réparateur réparations de bicyclette
mécanicien réparation de cycles
reparation de cycle
mecanicien reparations cycles
221
► API Reference
Query Term
Category
mécanicien réparations de cycle
ateliers de réparations de bicyclettes
atelier de réparations de cycle
mecanicien reparation de bicyclette
mecanicien reparation velo
atelier de réparations de bicyclettes
ateliers de reparation velo
réparation cycle
réparateur réparation de bicyclette
réparateur réparation vélos
mécanicien réparation de vélo
ateliers de réparations vélos
mécanicien réparation de cycle
mecanicien reparation de velo
ateliers de réparation de bicyclette
atelier de reparations cycle
mécanicien réparation de bicyclette
reparateur reparation de bicyclette
atelier de reparations de velo
atelier de reparations de cycle
réparations de cycle
mécanicien réparations bicyclettes
réparateur réparation de cycles
réparateur réparation de cycle
réparateur réparations de cycle
atelier de reparations velo
réparateur réparation cycles
mécanicien réparation bicyclette
réparateur réparations de vélos
reparateur reparation de velo
222
► API Reference
Query Term
Category
mécanicien réparation vélos
mécanicien réparations cycles
atelier de reparation de bicyclettes
ateliers de réparation de vélo
mécanicien réparation cycle
mecanicien reparation bicyclettes
ateliers de reparations de velo
mecanicien reparation de velos
atelier de réparations cycles
ateliers de réparation cycles
reparations de velos
ateliers de réparation de vélos
mecanicien reparations de cycle
atelier de reparation de velos
mecanicien reparation de bicyclettes
reparateur reparations de bicyclettes
mecanicien reparation bicyclette
atelier de réparations vélo
réparateur réparations bicyclettes
ateliers de reparations de cycles
atelier de reparation de bicyclette
reparateur reparations cycles
salle de billard billard
billiards-pool-hall
salles de billard billard
billiards-pool-hall
bateaux traversier
boat-ferry
bateau traversier
boat-ferry
bateau traversiers
boat-ferry
bateaux traversiers
boat-ferry
navigation de plaisance
boating
bateaux
boating
223
► API Reference
Query Term
Category
approvisionnement maritime
boating
vente de bateau
boating
vente de bateaux
boating
bateau
boating
fournitures marines
boating
location de bateaux
boating
plan d'eau
body-of-water
tatouages
body-piercing-and-tattoos
studio de perçage
tatoueur
salon de tatouage
studio de tatouage
salons de tatoo
studios de tatouage
studios de percage
studio de percage
tatoueurs
salon de tatoo
détatouage
tatoo et piercing
studios de piercing
studios de perçage
detatouage
perçage
studio de piercing
salons de tatouage
tatouages et piercings
tatouage piercing
tatouage
tatouage et percage
224
► API Reference
Query Term
Category
tatouage et perçage
effaçage de tatouage
tatouages piercings
percage
effacage de tatouage
postes frontière
border-crossing
passage de frontière
border-crossing
passages de frontière
border-crossing
poste frontalier
border-crossing
passages de frontiere
border-crossing
postes frontiere
border-crossing
passage de frontiere
border-crossing
frontiere
border-crossing
frontière
border-crossing
jeu de quilles
bowling
cuisine britannique
british
bus à haut niveau service
bus-rapid-transit
service rapide bus
bus-rapid-transit
bus haut niveau service
bus-rapid-transit
bus a haut niveau service
bus-rapid-transit
bus a haut niveau de service
bus-rapid-transit
service rapide par autobus
bus-rapid-transit
service rapide par bus
bus-rapid-transit
bus haut niveau de service
bus-rapid-transit
service rapide autobus
bus-rapid-transit
bus à haut niveau de service
bus-rapid-transit
gares routières
bus-terminal
gare routière
bus-terminal
terminus d’autobus
bus-terminal
gares routieres
bus-terminal
225
► API Reference
Query Term
Category
terminus d'autobus
bus-terminal
cafétéria|self service
cafeteria
cafeteria|self
cafeteria
cafétérias|self
cafeteria
cafeteria|self service
cafeteria
cafeterias|self services
cafeteria
cafétéria|self
cafeteria
cafeterias|self
cafeteria
cafétérias|self services
cafeteria
canadiens
canadian
canadienne
canadian
canadien
canadian
pieces automobiles et accessoires
pièces automobiles et accessoires
piece automobile et accessoire
pièce automobile et accessoire
location de voiture
car-rental
garages automobiles
car-repair
garage automobile
car-repair
garages autos
car-repair
garage automobiles
car-repair
garages automobile
car-repair
lave auto
car-wash-detailing
caraibes
caribbean
caraïbes
caribbean
cuisine decontractee
casual-dining
diner decontracte
casual-dining
cuisine décontractée
casual-dining
dîner décontracté
casual-dining
service restauration
catering-and-other-food-services
226
► API Reference
Query Term
Category
traiteurs
services restauration
service de restauration
traiteur
services de restauration
téléphone portable stationnement
cellphone-parking-lot
stationnements telephone portable
telephone portable stationnement
stationnements téléphone portable
bureau de changecheques
check-cashing-service-currency-exchange
encaissement de chèques
chèques
encaissement de cheques
cheques
bureau de changechèques
changecheques
encaissement cheques
encaissement chèques
bureau changecheques
bureau changechèques
changechèques
vêtements d'enfants
childrens-apparel
vetements pour enfants
childrens-apparel
vêtements pour enfants
childrens-apparel
pour enfants
childrens-apparel
vetements d'enfants
childrens-apparel
musees pour enfants
childrens-museum
musées pour enfants
childrens-museum
musee des enfants
childrens-museum
musées des enfants
childrens-museum
227
► API Reference
Query Term
Category
musée pour enfants
childrens-museum
musees des enfants
childrens-museum
musée des enfants
childrens-museum
musee pour enfants
childrens-museum
salle de cinéma
cinema
salle de cinema
cinema
vêtement
clothing
vetement
clothing
vêtement et accessoire
vetement et accessoire
salles polyvalentes
community-centre
centres municipaux
community-centre
salle polyvalente
community-centre
stations de trains banlieue
gare de train de banlieue
station de train de banlieue
train de banlieue
gare trains de banlieue
station de train banlieue
gare train de banlieue
stations de train banlieue
gares de train banlieue
train banlieue
gare de train banlieue
gares de train de banlieue
gares train de banlieue
gare de trains de banlieue
trains banlieue
station train de banlieue
gare trains banlieue
228
► API Reference
Query Term
Category
stations de trains de banlieue
gares train banlieue
gares trains banlieue
station trains de banlieue
stations de train de banlieue
station de trains banlieue
stations trains de banlieue
stations train banlieue
gare train banlieue
gares de trains banlieue
station trains banlieue
station de trains de banlieue
gare de trains banlieue
stations trains banlieue
gares trains de banlieue
gares de trains de banlieue
trains de banlieue
stations train de banlieue
station train banlieue
magasins d'informatique
computer-and-software
magasins de logiciel
logiciels
ordinateurs
magasins de logiciels
ordinateurs et logiciels
ordinateur et logiciels
magasins d'ordinateurs
ordinateur
magasin d'ordinateurs
magasin de logiciel
229
► API Reference
Query Term
Category
ordinateur et logiciel
ordinateurs et logiciel
magasins logiciel
magasin d'informatique
logiciel
magasins logiciels
magasin de logiciels
magasin logiciels
magasin logiciel
constructions en batiment
construction
construction bâtiment
construction
construction en bâtiment
construction
constructions batiment
construction
construction batiment
construction
construction en batiment
construction
constructions en bâtiment
construction
constructions bâtiment
construction
shop audio consummateur
consumer-electronics-store
boutique audio consummateur
shops de vidéo consummateur
magasin d' électronique consummateur
boutiques d' electronique de consummateur
magasins vidéo consummateur
boutique d' électronique
boutiques d' électronique consummateur
boutiques électronique consummateur
boutiques video de consummateur
magasins electronique de consummateur
boutique d' electronique consummateur
audio video
230
► API Reference
Query Term
Category
shops audio
magasins électronique
boutique vidéo consummateur
shops de audio de consummateur
système de son
boutiques vidéo de consummateur
shops electronique consummateur
shop electronique consummateur
systeme de son
magasins electronique consummateur
magasin video consummateur
tele
teles
shop de vidéo de consummateur
magasin de video consummateur
magasin d' electronique de consummateur
shops d' electronique
boutiques de vidéo de consummateur
boutique d' electronique
magasins de audio de consummateur
shop video de consummateur
magasins video de consummateur
magasin video
boutique de video
boutiques électronique
shop audio
shops électronique
magasins d' électronique
shops électronique de consummateur
magasins de vidéo consummateur
231
► API Reference
Query Term
Category
shop d' electronique de consummateur
shops electronique
shops électronique consummateur
boutique électronique
shop de video
shop electronique
boutiques audio consummateur
magasin vidéo de consummateur
magasins electronique
shop de audio
magasin electronique de consummateur
magasins audio
shops vidéo
shop de audio de consummateur
boutiques d' electronique consummateur
boutique d' électronique consummateur
boutiques de video consummateur
shops de video consummateur
shop d' electronique
shop de video consummateur
shop d' électronique
boutique electronique consummateur
magasin de video de consummateur
télévision
shop audio de consummateur
boutiques de video
magasins de vidéo
magasins de audio consummateur
boutiques electronique consummateur
systeme son
232
► API Reference
Query Term
Category
shop d' electronique consummateur
systemes son
boutique de video consummateur
magasins d' électronique consummateur
magasin électronique consummateur
shops d' electronique consummateur
magasin electronique consummateur
magasins de vidéo de consummateur
magasins d' électronique de consummateur
boutique d' electronique de consummateur
magasin audio
boutique audio
magasins d' electronique
magasin de audio de consummateur
shops de video
télévisions
magasins vidéo de consummateur
boutique video
shops de vidéo de consummateur
boutiques d' électronique
shops de audio
magasin de video
magasin vidéo
boutique de vidéo de consummateur
boutiques electronique
magasin de audio
magasins électronique consummateur
shop d' électronique consummateur
boutiques video
magasin d' electronique consummateur
233
► API Reference
Query Term
Category
shop électronique
shops vidéo consummateur
televiseurs
télés
shop vidéo
audio vidéo
shops d' électronique consummateur
magasins de video de consummateur
boutiques de vidéo consummateur
shop video consummateur
boutiques d' electronique
magasin electronique
boutiques de audio
boutiques video consummateur
magasin d' électronique de consummateur
boutiques de video de consummateur
television
boutique de vidéo
magasins vidéo
shops de video de consummateur
shops de audio consummateur
boutiques de audio consummateur
shop de video de consummateur
boutique video de consummateur
télé
boutique de audio de consummateur
systemes de son
shops vidéo de consummateur
shop d' électronique de consummateur
magasins de video consummateur
234
► API Reference
Query Term
Category
magasin d' electronique
magasin audio de consummateur
magasin d' électronique
magasins audio de consummateur
boutique de vidéo consummateur
magasin video de consummateur
shop de audio consummateur
boutique video consummateur
magasins d' electronique consummateur
boutiques electronique de consummateur
boutiques d' électronique de consummateur
téléviseur
boutique d' électronique de consummateur
boutique de audio
shops audio consummateur
téléviseurs
boutique audio de consummateur
systèmes de son
shop électronique consummateur
systèmes son
shop électronique de consummateur
magasin audio consummateur
boutique électronique de consummateur
boutiques de audio de consummateur
magasins de audio
boutiques de vidéo
televisions
magasins video
shops d' électronique
magasins d' electronique de consummateur
235
► API Reference
Query Term
Category
shops audio de consummateur
shops d' electronique de consummateur
électronique mobile
shop de vidéo
shop electronique de consummateur
televiseur
boutique de video de consummateur
magasin de vidéo de consummateur
shops video
magasin électronique de consummateur
shop de vidéo consummateur
shop vidéo de consummateur
shops d' électronique de consummateur
shop vidéo consummateur
magasins video consummateur
electronique mobile
shops de vidéo
boutique vidéo
shop video
magasin de vidéo consummateur
boutiques audio
boutique electronique de consummateur
magasin électronique
magasins électronique de consummateur
magasins audio consummateur
boutique de audio consummateur
magasin de audio consummateur
boutiques audio de consummateur
shops video de consummateur
magasin vidéo consummateur
236
► API Reference
Query Term
Category
boutiques vidéo consummateur
boutiques vidéo
magasin de vidéo
shops video consummateur
boutiques électronique de consummateur
magasins de video
boutique electronique
shops electronique de consummateur
boutique vidéo de consummateur
système son
boutique électronique consummateur
depanneur
convenience-store
épiceries
convenience-store
epicerie
convenience-store
épicerie
convenience-store
dépanneurs
convenience-store
dépanneur
convenience-store
depanneurs
convenience-store
epiceries
convenience-store
conseils de comté
county-council
conseil du comté
county-council
conseils de comte
county-council
conseil du comte
county-council
service messagerie
couriers
de messagerie courrier
couriers
messagerie courrier
couriers
messager
couriers
service de messagerie
couriers
services messagerie
couriers
services de messagerie
couriers
237
► API Reference
Query Term
Category
studio de danse
dancing
danse
dancing
studios de danse
dancing
épiceries fines
deli
epiceries fines
deli
boutique traiteur
deli
traiteurs
deli
traiteur
deli
boutiques traiteurs
deli
epicerie fine
deli
épicerie fine
deli
magasin discount
discount-store
magasins discount
discount-store
centre de plongée
diving-centre
plongee
diving-centre
centres de plongée sous marine
diving-centre
plongee sous marine
diving-centre
plongée
diving-centre
centre plongée sous marine
diving-centre
centres plongée sous marine
diving-centre
centres de plongee sous marine
diving-centre
centres plongee sous marine
diving-centre
centre de plongée sous marine
diving-centre
centre plongee sous marine
diving-centre
plongée sous marine
diving-centre
centres de plongee
diving-centre
centre de plongee
diving-centre
centre de plongee sous marine
diving-centre
centres de plongée
diving-centre
médecine générale
doctor
238
► API Reference
Query Term
Category
medecine generale
doctor
drogueries
drug-store
droguerie
drug-store
hollandaise
dutch
néerlandaise
dutch
neerlandais
dutch
neerlandaise
dutch
hollandais
dutch
néerlandais
dutch
etablissement d'enseignement
education-facility
établissement d'enseignement
education-facility
consulats et ambassades
embassy-consulate
station d’appel d’urgence
emergency-call-station
stations d’appel d’urgence
stations d'appels d'urgence
inspection des émissions
emission-testing
essai d'émission
emission-testing
emissions
emission-testing
controle d'emission
emission-testing
émissions
emission-testing
controle des emissions
emission-testing
inspection des emissions
emission-testing
essai d'emission
emission-testing
contrôles de smog
emission-testing
essais d'emission
emission-testing
essais relatifs aux emissions
emission-testing
essais d'émission
emission-testing
contrôle des émissions
emission-testing
inspections des émissions
emission-testing
essais relatifs aux émissions
emission-testing
239
► API Reference
Query Term
Category
controles des emissions
emission-testing
inspections des emissions
emission-testing
contrôle d'émission
emission-testing
controles de smog
emission-testing
contrôles des émissions
emission-testing
divertissement et loisirs
entertainment-and-recreation
electronique de divertissement
électronique de divertissement
station recharge
ev-charging-station
stations recharge
ev-charging-station
bornes de charge
ev-charging-station
stations de charge
ev-charging-station
point de charge
ev-charging-station
borne charge
ev-charging-station
point recharge
ev-charging-station
station de charge
ev-charging-station
stations charge
ev-charging-station
bornes charge
ev-charging-station
points de recharge
ev-charging-station
point charge
ev-charging-station
station de recharge
ev-charging-station
borne de recharge
ev-charging-station
bornes de recharge
ev-charging-station
station charge
ev-charging-station
point de recharge
ev-charging-station
bornes recharge
ev-charging-station
points recharge
ev-charging-station
borne de charge
ev-charging-station
borne recharge
ev-charging-station
stations de recharge
ev-charging-station
240
► API Reference
Query Term
Category
points charge
ev-charging-station
points de charge
ev-charging-station
parcs déxposition
exhibition-centre
parcs déxpositions
exhibition-centre
parc déxposition
exhibition-centre
centres d'exposition
exhibition-centre
centre d'expositions et de congres
centre d'expositions et de congrès
finances et assurance
finance-and-insurance
finances et assurances
finance et assurance
assurance
assurances
finance et assurances
restaurant gastronomique
fine-dining
restaurants de cuisine raffinee
fine-dining
cuisine raffinée
fine-dining
restaurant cuisine raffinée
fine-dining
restaurants de cuisine raffinée
fine-dining
restaurants gastronomiques
fine-dining
restaurants cuisine raffinée
fine-dining
restaurants cuisine raffinee
fine-dining
restaurants gastronomique
fine-dining
restaurant de cuisine raffinee
fine-dining
restaurant de cuisine raffinée
fine-dining
cuisine raffinee
fine-dining
restaurant cuisine raffinee
fine-dining
restaurant gastronomiques
fine-dining
centre de formation
fitness-health-club
centres de remise en forme
fitness-health-club
241
► API Reference
Query Term
Category
clubs de fitness
fitness-health-club
salles de sport de remise en forme
fitness-health-club
club de remise en forme sante
fitness-health-club
club de sante
fitness-health-club
centres de fitness
fitness-health-club
centres de gymnastique
fitness-health-club
salle de gym
fitness-health-club
clubs de fitness santé
fitness-health-club
club de remise en forme santé
fitness-health-club
salle de fitness
fitness-health-club
seance d'entrainement
fitness-health-club
salles de sport
fitness-health-club
club de remise en forme
fitness-health-club
clubs de fitness sante
fitness-health-club
club de santé
fitness-health-club
seances d'entrainement
fitness-health-club
club athlétique
fitness-health-club
clubs de gym
fitness-health-club
centre de remise en forme
fitness-health-club
centre de gym
fitness-health-club
club athletique
fitness-health-club
clubs de sport
fitness-health-club
séances d'entraînement
fitness-health-club
club de gym
fitness-health-club
remise en forme
fitness-health-club
séance d'entraînement
fitness-health-club
clubs de sante
fitness-health-club
centres de formation
fitness-health-club
clubs de santé
fitness-health-club
plancher en bois
floor-and-carpet
242
► API Reference
Query Term
Category
revetements de sol
floor-and-carpet
plancher
floor-and-carpet
plancher et tapis
floor-and-carpet
revêtements de sol
floor-and-carpet
planchers et tapis
floor-and-carpet
carrelage
floor-and-carpet
plancher de bois franc
floor-and-carpet
fleurs et bijoux
flowers-and-jewelry
alimentaire
food
aliments
food
magasins d'alimentation
food
magasin d'alimentation
food
alimentation
food
magasins specialises de alimentation
food-beverage-specialty-store
magasins de spécialisé de alimentation
magasin spécialisés de alimentation
magasin spécialisé nourriture
magasin de spécialisés de boisson
magasins spécialisés nourriture
magasin de specialises de alimentation
magasins spécialisé de nourriture
magasin de specialise nourriture
magasins spécialisés de alimentation
magasins specialise de alimentation
magasin spécialisés de nourriture
magasins specialises de nourriture
magasins specialises de boisson
magasins spécialisés boisson
magasins de spécialisés de boisson
magasins de spécialisés boisson
243
► API Reference
Query Term
Category
magasins specialise nourriture
magasin de specialises de nourriture
magasins de specialise alimentation
magasins specialise de nourriture
magasins de specialises boisson
magasins spécialisés alimentation
magasins de specialises nourriture
magasins de spécialisé de nourriture
magasin spécialisés de boisson
magasins specialises alimentation
magasin de spécialisés nourriture
magasin spécialisé de alimentation
magasins de specialise de alimentation
magasins de specialise de boisson
magasins de specialises de boisson
magasin de spécialisés alimentation
magasins spécialisé boisson
magasin specialise de boisson
magasin de spécialisés boisson
magasin de specialise de alimentation
magasins de spécialisé alimentation
magasin specialises alimentation
magasin specialises de boisson
magasins de spécialisés de nourriture
magasins de specialises de nourriture
magasin de specialise de boisson
magasin spécialisés boisson
magasins de specialises de alimentation
magasin specialise alimentation
magasins spécialisé de alimentation
244
► API Reference
Query Term
Category
magasins de specialise de nourriture
magasins specialise de boisson
magasin de spécialisé de alimentation
magasin spécialisé boisson
magasin spécialisé de boisson
magasin de spécialisé de nourriture
magasin specialise de nourriture
magasin de specialises nourriture
magasin specialise nourriture
magasin specialises boisson
magasin specialise de alimentation
magasins de specialise nourriture
magasin de spécialisé nourriture
magasin de spécialisés de alimentation
magasin specialises nourriture
magasin de specialises alimentation
magasin spécialisés nourriture
magasin specialise boisson
magasins specialise boisson
magasin spécialisé alimentation
magasins spécialisé de boisson
magasin de spécialisé de boisson
magasins de spécialisé boisson
magasin de specialises boisson
magasins de spécialisé nourriture
magasin specialises de alimentation
magasin de spécialisés de nourriture
magasins specialise alimentation
magasin specialises de nourriture
magasins spécialisé alimentation
245
► API Reference
Query Term
Category
magasins de specialise boisson
magasins de spécialisés alimentation
magasins de specialises alimentation
magasin de specialise alimentation
magasins de spécialisé de boisson
magasin spécialisés alimentation
magasins specialises nourriture
magasin de specialises de boisson
magasin de specialise boisson
magasins specialises boisson
magasins de spécialisés nourriture
magasins de spécialisés de alimentation
magasins spécialisés de boisson
magasin spécialisé de nourriture
magasin de spécialisé boisson
magasins spécialisé nourriture
magasin de specialise de nourriture
magasins spécialisés de nourriture
magasin de spécialisé alimentation
etals de marche alimentaire
food-market-stall
étal de marché alimentaire
food-market-stall
étals de marché alimentaire
food-market-stall
etal de marche alimentaire
food-market-stall
production alimentaire
food-production
productions alimentaires
food-production
français
french
française
french
francais
french
francaise
french
obseques
funeral-director
246
► API Reference
Query Term
Category
services funéraires
funeral-director
cercueil
funeral-director
services funeraires
funeral-director
funerailles
funeral-director
obsèques
funeral-director
maisons funéraire
funeral-director
salon funéraires
funeral-director
funérailles
funeral-director
mortuaire
funeral-director
salon funeraires
funeral-director
salons funeraires
funeral-director
salons funéraires
funeral-director
mortuaires
funeral-director
maison funéraire
funeral-director
morgues
funeral-director
morgue
funeral-director
cercueils
funeral-director
maisons funeraire
funeral-director
maison funeraire
funeral-director
sortie de meubles
furniture-store
magasins de meubles
furniture-store
ameublement de maison
furniture-store
magasin de meubles
furniture-store
ameublement
furniture-store
meubles
furniture-store
discount meubles
furniture-store
mobilier de maison
furniture-store
mobilier
furniture-store
galeries d'art
gallery
galerie d'art
gallery
247
► API Reference
Query Term
Category
galerie art
gallery
galerie beaux arts
gallery
jardins
garden
jardin
garden
approvisionnement de jardin
garden-center
jardineries
garden-center
jardinerie
garden-center
jardinage
garden-center
commerce détail
general-merchandise
commerc detail
general-merchandise
commerc détail
general-merchandise
commerc de détail
general-merchandise
commerce de detail
general-merchandise
commerce detail
general-merchandise
commerc de detail
general-merchandise
commerce de détail
general-merchandise
allemande
german
allemands
german
boutique d' art
gift-antique-and-art
halles d' antiquites
antiquites cadeaux
magasin d' art
antiquites
halles aux antiquités
art antiquites
boutiques d'antiquités
boutique d'antiquites
collectionneur
halles antiquites
antiquaires
248
► API Reference
Query Term
Category
magasin d'antiquités
boutiques d' art
halles d' antiquités
boutique art
magasins d'antiquités
antiquites arts
cadeau
magasins art
antiquités arts
boutiques art
magasin d'antiquites
boutiques de cadeaux
magasin cadeaux
marche d'antiquites
magasin de cadeaux
boutique d'antiquités
antiquités
cadeaux artistiques
halles aux antiquites
antiquités cadeaux
souvenirs
art antiquités
boutiques cadeaux
boutique de cadeaux
marche de l'art
magasins cadeaux
magasins d'antiquites
marché de l'art
magasins d' art
marché d'antiquités
249
► API Reference
Query Term
Category
objets de collection
magasin art
boutiques d'antiquites
boutique cadeaux
halles antiquités
magasins de cadeaux
fenêtre
glass-and-window
fenetre
glass-and-window
porte vitrée
glass-and-window
vitres et fenêtres
glass-and-window
porte fenetre
glass-and-window
porte vitree
glass-and-window
verre
glass-and-window
fenêtre anti moustiques
glass-and-window
vitrail
glass-and-window
fenetre anti moustiques
glass-and-window
verre et fenêtre
glass-and-window
vitres et fenetres
glass-and-window
verre et fenetre
glass-and-window
portes et fenetres
glass-and-window
portes et fenêtres
glass-and-window
porte fenêtre
glass-and-window
clubs de golf
golf-course
champs d'exercice
golf-practice-range
gammes de pratique de golf
golf-practice-range
practice de golf
golf-practice-range
pratiсes de golf
golf-practice-range
bureaux du gouvernement
government-office
bureau gouvernement
government-office
bureaux gouvernement
government-office
250
► API Reference
Query Term
Category
bureau du gouvernement
government-office
epicerie
grocery
épiceries
grocery
magasin d'alimentation
grocery
alimentation
grocery
boutique de produits d'épicerie
grocery
alimentaire
grocery
magasin d'epicerie
grocery
boutique de produits d'epicerie
grocery
magasins de produits d'épicerie
grocery
magasin d'épicerie
grocery
epiceries
grocery
super marches
grocery
super marchés
grocery
aliments
grocery
epicier
grocery
marchés alimentaires
grocery
épicerie
grocery
marché alimentaire
grocery
marches alimentaires
grocery
magasins d'alimentation
grocery
marche alimentaire
grocery
magasins de produits d'epicerie
grocery
épicier
grocery
chambres d'hotes
guest-house
chambres d'hôtes
guest-house
maison d'hotes
guest-house
maison d'hôtes
guest-house
maisons d'hôtes
guest-house
maisons d'hotes
guest-house
251
► API Reference
Query Term
Category
maisons et jardins
hawaïens
hawaiian-polynesian
hawaiens
hawaiian-polynesian
hawaiiens
hawaiian-polynesian
hawaiienne
hawaiian-polynesian
hawaiien
hawaiian-polynesian
sorties d'autoroute
highway-exit
sortie d'autoroute
highway-exit
historique
historical-monument
lieu historique
historical-monument
monument historique
historical-monument
lieux historiques
historical-monument
monuments historiques
historical-monument
musée d'histoire
history-museum
musee d'histoire
history-museum
musees d'histoire
history-museum
histoire
history-museum
musées d'histoire
history-museum
hockey sur glace
hockey
outils
quincailleries
magasin de bricolage
magasins de bricolage
magasins bricolage
boutique matériel
boutiques bricolage
magasins de matériel
bricolage
magasin de rénovation domiciliaire
boutique de materiel
252
► API Reference
Query Term
Category
boutique de matériel
magasins materiel
magasin de materiel
magasin renovation domiciliaire
magasins matériel
boutiques de bricolage
magasin matériel
magasin bricolage
magasin materiel
boutiques matériel
magasin de matériel
boutiques materiel
quincaillerie
boutiques de matériel
boutiques de materiel
boutique bricolage
outil
magasin de renovation domiciliaire
magasins de materiel
magasin rénovation domiciliaire
boutique de bricolage
boutique materiel
meubles et décoration d'intérieur
home-specialty-store
meubles et decoration d'interieur
home-specialty-store
hopitaux et centres de soins
hopital et centre de soins
hôpital et centre de soins
hôpitaux et centres de soins
ressources humaines et service recrutement
human-resources-and-recruiting-services
travailler la dotation
253
► API Reference
Query Term
Category
agences pour l'emploi
agences de pour l'emploi
agence de d'emploi
agences de d'emploi
emplois
service de d'emploi
agence dotation
emploi
service de dotation
dotation
agence d'emploi
service pour l'emploi
service de placement temporaire
service de pour l'emploi
agence placement temporaire
ressources humaines
service d'emploi
service placement temporaire
services de pour l'emploi
services placement temporaire
services de dotation
services d'emploi
agences dotation
services dotation
agences placement temporaire
recrutement
services de placement temporaire
agences de placement temporaire
service dotation
agences de dotation
254
► API Reference
Query Term
Category
services pour l'emploi
services de d'emploi
ressources humaines et services de recrutement
agences d'emploi
agence de pour l'emploi
agence de dotation
agence pour l'emploi
agence de placement temporaire
crème glacée
ice-cream
creme glacee
ice-cream
sports d'intérieur
indoor-sports
sport d'interieur
indoor-sports
sports d'interieur
indoor-sports
sports en salle
indoor-sports
sport d'intérieur
indoor-sports
sport en salle
indoor-sports
cybercafés
internet-cafe
cyber cafés
internet-cafe
cyber cafe
internet-cafe
cyber café
internet-cafe
cybercafé
internet-cafe
cybercafes
internet-cafe
cyber cafes
internet-cafe
cybercafe
internet-cafe
musique
jazz-club
clubs de jazz
jazz-club
bar de jazz
jazz-club
concerts de jazz
jazz-club
club de jazz
jazz-club
bars de jazz
jazz-club
255
► API Reference
Query Term
Category
concert de jazz
jazz-club
musique jazz
jazz-club
karaoke
karaoke
bar karaoke
karaoke
karaoké
karaoke
bars karaoke
karaoke
bars karaoké
karaoke
bar karaoké
karaoke
jardins d’enfants
kindergarten
jardin d’enfants
kindergarten
curiosité
landmark-attraction
vues
landmark-attraction
curiosite
landmark-attraction
amenagement paysager
landscaping-services
aménagement du téritoire
aménagement paysager
amenagement du teritoire
pressing
laundry
nettoyages a sec
laundry
nettoyage a sec
laundry
laverie
laundry
nettoyages à sec
laundry
pressings
laundry
nettoyage à sec
laundry
laveries
laundry
performance live
live-entertainment-music
musique en direct
concerts live
musique
performancesen direct
256
► API Reference
Query Term
Category
performances live
concertsen direct
concert live
musique live
performanceen direct
concerten direct
quais de chargement
loading-dock
quai de chargement
loading-dock
transport en commun local
local-transit
transits locaux
local-transit
clé serrure
locksmiths-and-security-systems-services
serruriers
serruriers et services de systemes de securite
serrurier sécurité
serrurier
cle serrure
serrures
serrures à clé
serruriers et services de systèmes de sécurité
clef de serrure
serrurier securite
cle
cle de serrure
serruriers securite
serrures a cle
clés
clé
clef serrure
clef
cles serrure
257
► API Reference
Query Term
Category
serruriers sécurité
serrure
cles de serrure
clés serrure
serrurier et service de systemes de securite
clé de serrure
clefs de serrure
cles
clefs serrure
clefs
clés de serrure
serrurier et service de systèmes de sécurité
magasins bois
lumber
bois bois
lumber
bois usine
lumber
travail du moulin
lumber
oeuvres de moulin
lumber
bois de sciage
lumber
magasin de bois de oeuvre
lumber
menuiserie
lumber
œuvres de moulin
lumber
magasin de bois de œuvre
lumber
boutique du bois
lumber
avance lourdement
lumber
comptoir lunch
lunch
déjeuner
lunch
dejeuner
lunch
service d'entretien menager
maid-services
servicesentretien ménager
maid-services
serviceentretien menager
maid-services
258
► API Reference
Query Term
Category
service de femmede chambre
maid-services
service femmede chambre
maid-services
service d'entretien ménager
maid-services
services d'entretien menager
maid-services
services femmede chambre
maid-services
services de femmede chambre
maid-services
serviceentretien ménager
maid-services
servicesentretien menager
maid-services
services d'entretien ménager
maid-services
magasin de appareils ménagers
major-appliance
magasin de appareil menager
major-appliance
gros appareil menager
major-appliance
magasins de appareil menager
major-appliance
appareils ménagers
major-appliance
magasins de appareil ménager
major-appliance
magasin de appareil ménager
major-appliance
magasins de appareils menagers
major-appliance
appareils menagers
major-appliance
magasin de appareils menagers
major-appliance
gros appareil ménager
major-appliance
magasins de appareils ménagers
major-appliance
conseil
management-and-consulting-services
agences de conseil
agence de conseil
marché
market
marchés
market
marches
market
marche
market
boutique vêtements hommes
mens-apparel
magasin vetements hommes
mens-apparel
259
► API Reference
Query Term
Category
vetements hommes
mens-apparel
boutique vêtements pour hommes
mens-apparel
boutiques vetements hommes
mens-apparel
boutiques de mode pour hommes
mens-apparel
magasin de vetements hommes
mens-apparel
magasin de vetements pour hommes
mens-apparel
vetements pour hommes
mens-apparel
boutique mode masculine
mens-apparel
boutiques de vetements pour hommes
mens-apparel
boutiques de mode masculine
mens-apparel
magasins de mode pour hommes
mens-apparel
boutique mode pour hommes
mens-apparel
magasins de mode hommes
mens-apparel
boutiques de vetements hommes
mens-apparel
magasin de mode pour hommes
mens-apparel
magasins mode pour hommes
mens-apparel
boutique de vêtements pour hommes
mens-apparel
boutique de mode masculine
mens-apparel
magasins vêtements hommes
mens-apparel
magasin mode masculine
mens-apparel
mode masculine
mens-apparel
magasin de mode masculine
mens-apparel
magasins de vêtements hommes
mens-apparel
magasin vêtements hommes
mens-apparel
boutiques mode hommes
mens-apparel
boutiques mode masculine
mens-apparel
boutiques vetements pour hommes
mens-apparel
boutique vetements pour hommes
mens-apparel
magasin de vêtements hommes
mens-apparel
magasins vetements pour hommes
mens-apparel
260
► API Reference
Query Term
Category
boutiques vêtements hommes
mens-apparel
boutique vetements hommes
mens-apparel
boutiques de mode hommes
mens-apparel
magasins mode masculine
mens-apparel
boutique de mode pour hommes
mens-apparel
vêtements hommes
mens-apparel
vêtements pour hommes
mens-apparel
boutique de vetements hommes
mens-apparel
boutiques de vêtements hommes
mens-apparel
boutique de vêtements hommes
mens-apparel
boutiques mode pour hommes
mens-apparel
magasin mode hommes
mens-apparel
magasins de mode masculine
mens-apparel
magasin vetements pour hommes
mens-apparel
magasin de vêtements pour hommes
mens-apparel
magasins mode hommes
mens-apparel
boutiques vêtements pour hommes
mens-apparel
boutique de vetements pour hommes
mens-apparel
boutique mode hommes
mens-apparel
magasins de vêtements pour hommes
mens-apparel
magasin de mode hommes
mens-apparel
magasins vêtements pour hommes
mens-apparel
magasin mode pour hommes
mens-apparel
magasins de vetements pour hommes
mens-apparel
magasins vetements hommes
mens-apparel
boutiques de vêtements pour hommes
mens-apparel
magasins de vetements hommes
mens-apparel
magasin vêtements pour hommes
mens-apparel
boutique de mode hommes
mens-apparel
logistique et transport divers
misc-transportation-and-logistics
261
► API Reference
Query Term
Category
orientaux (assortiments)
mixed-oriental
oriental (assortiment)
mixed-oriental
détaillant de téléphones cellulaire
mobile-retailer
telephones mobile
mobile-retailer
magasin telephones portable
mobile-retailer
boutique de téléphones mobile
mobile-retailer
boutiques telephones portables
mobile-retailer
detaillants de telephones portables
mobile-retailer
magasins téléphones mobiles
mobile-retailer
detaillant de telephones cellulaires
mobile-retailer
détaillants de téléphone mobiles
mobile-retailer
boutique de téléphones portable
mobile-retailer
detaillants telephone portable
mobile-retailer
revendeur portable
mobile-retailer
magasins telephones cellulaires
mobile-retailer
boutique de telephones mobiles
mobile-retailer
detaillant de telephone portables
mobile-retailer
detaillant telephones mobile
mobile-retailer
magasins téléphones cellulaire
mobile-retailer
magasins de téléphone portables
mobile-retailer
magasin telephones portables
mobile-retailer
magasins de telephone mobiles
mobile-retailer
détaillant de téléphones portables
mobile-retailer
boutiques de téléphones cellulaire
mobile-retailer
boutique de téléphones cellulaire
mobile-retailer
boutiques telephones mobile
mobile-retailer
détaillant de téléphone portables
mobile-retailer
détaillants de téléphones mobiles
mobile-retailer
boutiques téléphones mobiles
mobile-retailer
boutiques de téléphones mobiles
mobile-retailer
262
► API Reference
Query Term
Category
boutique telephones cellulaires
mobile-retailer
boutiques de téléphone portable
mobile-retailer
détaillant téléphone portable
mobile-retailer
boutiques de téléphones cellulaires
mobile-retailer
magasins telephone portable
mobile-retailer
boutiques telephones mobiles
mobile-retailer
magasin téléphones mobiles
mobile-retailer
boutique téléphone cellulaire
mobile-retailer
magasin de téléphone cellulaire
mobile-retailer
magasins de telephone portable
mobile-retailer
magasins de telephones portable
mobile-retailer
détaillant téléphones cellulaires
mobile-retailer
boutiques de téléphone cellulaires
mobile-retailer
telephones mobiles
mobile-retailer
revendeurs cellulaires
mobile-retailer
magasin de téléphones portables
mobile-retailer
detaillants telephone cellulaire
mobile-retailer
magasin telephone portables
mobile-retailer
boutiques de téléphone mobile
mobile-retailer
détaillant téléphone cellulaires
mobile-retailer
detaillant telephones portables
mobile-retailer
detaillant telephone mobile
mobile-retailer
boutique telephones mobile
mobile-retailer
magasins de telephones mobile
mobile-retailer
magasins de téléphones cellulaire
mobile-retailer
détaillant téléphones portables
mobile-retailer
détaillants téléphones portables
mobile-retailer
magasins de téléphone
mobile-retailer
boutique telephone portable
mobile-retailer
magasin de téléphonie mobile
mobile-retailer
263
► API Reference
Query Term
Category
detaillants de telephones mobiles
mobile-retailer
magasins de téléphones portables
mobile-retailer
magasin de téléphones cellulaire
mobile-retailer
detaillants telephones portables
mobile-retailer
boutique de téléphone portables
mobile-retailer
revendeurs portables
mobile-retailer
detaillant de telephone mobiles
mobile-retailer
téléphones cellulaires
mobile-retailer
boutique de téléphone portable
mobile-retailer
boutique téléphone mobile
mobile-retailer
revendeur portables
mobile-retailer
telephones cellulaire
mobile-retailer
boutiques telephones portable
mobile-retailer
détaillant téléphones mobiles
mobile-retailer
detaillants telephone mobile
mobile-retailer
magasin de telephone portable
mobile-retailer
magasins téléphone mobile
mobile-retailer
détaillants de téléphones portables
mobile-retailer
détaillants de téléphone portables
mobile-retailer
boutique de telephones cellulaires
mobile-retailer
detaillant de telephone cellulaires
mobile-retailer
detaillants telephones cellulaire
mobile-retailer
magasin de téléphones cellulaires
mobile-retailer
magasin de téléphone mobiles
mobile-retailer
detaillant telephone mobiles
mobile-retailer
magasin telephone mobile
mobile-retailer
detaillants de telephones cellulaire
mobile-retailer
magasin telephone cellulaires
mobile-retailer
boutiques de téléphones portables
mobile-retailer
magasins de téléphones portable
mobile-retailer
264
► API Reference
Query Term
Category
magasins de téléphones
mobile-retailer
detaillants de telephone cellulaires
mobile-retailer
magasin de téléphone cellulaires
mobile-retailer
boutiques telephone mobile
mobile-retailer
magasins de téléphone cellulaire
mobile-retailer
cellulaire
mobile-retailer
magasins téléphone portable
mobile-retailer
boutique telephone mobile
mobile-retailer
détaillants téléphones portable
mobile-retailer
revendeurs cellulaire
mobile-retailer
boutiques telephones cellulaire
mobile-retailer
detaillants de telephone portable
mobile-retailer
boutiques de telephone cellulaires
mobile-retailer
boutiques de telephone mobiles
mobile-retailer
boutiques téléphone portable
mobile-retailer
detaillant de telephone cellulaire
mobile-retailer
magasins téléphones cellulaires
mobile-retailer
téléphones cellulaire
mobile-retailer
boutiques de telephones portables
mobile-retailer
magasins telephones
mobile-retailer
boutiques téléphone portables
mobile-retailer
boutique téléphone cellulaires
mobile-retailer
détaillant téléphones cellulaire
mobile-retailer
magasin téléphones cellulaire
mobile-retailer
magasin téléphones portables
mobile-retailer
detaillant telephones cellulaire
mobile-retailer
téléphone cellulaires
mobile-retailer
magasins de telephone cellulaire
mobile-retailer
detaillant telephones cellulaires
mobile-retailer
détaillant de téléphones cellulaires
mobile-retailer
265
► API Reference
Query Term
Category
boutiques de téléphones portable
mobile-retailer
boutique téléphone mobiles
mobile-retailer
détaillant téléphone cellulaire
mobile-retailer
magasin de téléphone portable
mobile-retailer
détaillants de téléphone mobile
mobile-retailer
magasin de telephones cellulaire
mobile-retailer
telephones
mobile-retailer
magasin de telephone mobile
mobile-retailer
magasin téléphones portable
mobile-retailer
telephones cellulaires
mobile-retailer
magasins telephones cellulaire
mobile-retailer
magasin de téléphone mobile
mobile-retailer
boutiques de téléphones mobile
mobile-retailer
detaillants de telephone cellulaire
mobile-retailer
boutique téléphones portable
mobile-retailer
détaillant de téléphone mobiles
mobile-retailer
magasins de telephone mobile
mobile-retailer
detaillants telephone cellulaires
mobile-retailer
magasin téléphone cellulaire
mobile-retailer
boutique telephones portable
mobile-retailer
boutique de telephone mobiles
mobile-retailer
boutiques telephone cellulaires
mobile-retailer
magasin de téléphone portables
mobile-retailer
detaillant telephone portables
mobile-retailer
téléphones portable
mobile-retailer
revendeur cellulaires
mobile-retailer
magasin de telephones portable
mobile-retailer
magasins telephone
mobile-retailer
boutiques de téléphone portables
mobile-retailer
detaillants de telephones portable
mobile-retailer
266
► API Reference
Query Term
Category
telephone cellulaire
mobile-retailer
boutiques de téléphone cellulaire
mobile-retailer
boutique telephone cellulaires
mobile-retailer
magasin de téléphones mobile
mobile-retailer
telephone portable
mobile-retailer
détaillant de téléphones portable
mobile-retailer
boutiques de telephones mobile
mobile-retailer
magasins telephones portable
mobile-retailer
boutiques de telephone portables
mobile-retailer
détaillants téléphones mobile
mobile-retailer
boutique téléphones mobile
mobile-retailer
magasins de téléphone mobiles
mobile-retailer
détaillant de téléphone portable
mobile-retailer
boutiques téléphones cellulaires
mobile-retailer
revendeurs mobile
mobile-retailer
magasins telephones mobiles
mobile-retailer
detaillants telephones mobiles
mobile-retailer
boutiques de téléphone mobiles
mobile-retailer
telephone mobiles
mobile-retailer
magasin telephones cellulaires
mobile-retailer
magasins de telephone cellulaires
mobile-retailer
magasins de telephones portables
mobile-retailer
boutique telephone cellulaire
mobile-retailer
détaillant de téléphone cellulaire
mobile-retailer
boutique de telephone cellulaires
mobile-retailer
boutique de telephones mobile
mobile-retailer
magasins de téléphones mobile
mobile-retailer
détaillants de téléphone cellulaires
mobile-retailer
magasins téléphone
mobile-retailer
magasin telephone portable
mobile-retailer
267
► API Reference
Query Term
Category
cellulaires
mobile-retailer
détaillant de téléphones mobile
mobile-retailer
détaillants téléphones mobiles
mobile-retailer
détaillant de téléphones mobiles
mobile-retailer
boutique de téléphone cellulaires
mobile-retailer
détaillants téléphone mobile
mobile-retailer
boutiques de telephone mobile
mobile-retailer
boutique téléphones mobiles
mobile-retailer
detaillants telephone portables
mobile-retailer
boutiques téléphone cellulaires
mobile-retailer
magasin téléphone portable
mobile-retailer
detaillants de telephone mobile
mobile-retailer
boutiques de telephone portable
mobile-retailer
magasin telephones mobiles
mobile-retailer
boutiques telephone portables
mobile-retailer
boutique de téléphone mobile
mobile-retailer
détaillant de téléphone cellulaires
mobile-retailer
boutiques téléphone mobiles
mobile-retailer
téléphone mobiles
mobile-retailer
magasin de telephone cellulaires
mobile-retailer
magasins telephone cellulaire
mobile-retailer
revendeur mobile
mobile-retailer
magasins de telephone portables
mobile-retailer
detaillants telephones cellulaires
mobile-retailer
boutique de telephone mobile
mobile-retailer
détaillant téléphone mobile
mobile-retailer
magasins de téléphones cellulaires
mobile-retailer
detaillant telephones mobiles
mobile-retailer
magasins telephones mobile
mobile-retailer
magasin de téléphones portable
mobile-retailer
268
► API Reference
Query Term
Category
téléphone portables
mobile-retailer
magasins téléphones portable
mobile-retailer
boutique telephone mobiles
mobile-retailer
revendeurs portable
mobile-retailer
boutique de telephone portable
mobile-retailer
téléphone
mobile-retailer
boutiques telephone cellulaire
mobile-retailer
telephones portables
mobile-retailer
telephones portable
mobile-retailer
magasin téléphone cellulaires
mobile-retailer
detaillant telephones portable
mobile-retailer
boutiques téléphones cellulaire
mobile-retailer
détaillants de téléphones cellulaire
mobile-retailer
boutiques de telephones cellulaires
mobile-retailer
magasins de telephones cellulaire
mobile-retailer
detaillants telephones portable
mobile-retailer
magasins de téléphone cellulaires
mobile-retailer
magasins de téléphone portable
mobile-retailer
detaillants de telephone portables
mobile-retailer
boutiques téléphone mobile
mobile-retailer
boutique telephones portables
mobile-retailer
magasins de téléphone mobile
mobile-retailer
magasins téléphone portables
mobile-retailer
boutique telephones mobiles
mobile-retailer
détaillants de téléphone cellulaire
mobile-retailer
magasins telephone mobile
mobile-retailer
detaillant de telephones mobile
mobile-retailer
téléphones portables
mobile-retailer
magasins de téléphones mobiles
mobile-retailer
téléphone portable
mobile-retailer
269
► API Reference
Query Term
Category
magasins de telephones cellulaires
mobile-retailer
boutiques téléphone cellulaire
mobile-retailer
boutique telephones cellulaire
mobile-retailer
magasins téléphone mobiles
mobile-retailer
magasin de telephone mobiles
mobile-retailer
détaillants téléphones cellulaires
mobile-retailer
boutiques de telephones portable
mobile-retailer
telephone
mobile-retailer
telephone portables
mobile-retailer
telephone mobile
mobile-retailer
détaillants téléphone mobiles
mobile-retailer
magasin de téléphones mobiles
mobile-retailer
boutiques de telephones cellulaire
mobile-retailer
detaillants telephone mobiles
mobile-retailer
magasins téléphone cellulaires
mobile-retailer
détaillants téléphone cellulaire
mobile-retailer
téléphone cellulaire
mobile-retailer
boutique téléphones portables
mobile-retailer
détaillant téléphone portables
mobile-retailer
magasins téléphones
mobile-retailer
boutiques de telephones mobiles
mobile-retailer
detaillants de telephone mobiles
mobile-retailer
boutique de telephone portables
mobile-retailer
magasin téléphone mobiles
mobile-retailer
magasin de telephone portables
mobile-retailer
detaillant de telephone mobile
mobile-retailer
téléphones mobile
mobile-retailer
boutique de téléphones mobiles
mobile-retailer
magasin de telephones mobiles
mobile-retailer
détaillants de téléphones portable
mobile-retailer
270
► API Reference
Query Term
Category
boutique téléphones cellulaires
mobile-retailer
magasin de telephones cellulaires
mobile-retailer
magasins de telephones
mobile-retailer
detaillants de telephones cellulaires
mobile-retailer
magasins téléphone cellulaire
mobile-retailer
boutique de téléphone mobiles
mobile-retailer
detaillant de telephones mobiles
mobile-retailer
magasin de telephonie mobile
mobile-retailer
detaillant de telephones portable
mobile-retailer
détaillants de téléphone portable
mobile-retailer
détaillants de téléphones cellulaires
mobile-retailer
détaillant téléphones portable
mobile-retailer
detaillant de telephone portable
mobile-retailer
magasins telephone portables
mobile-retailer
magasins telephone cellulaires
mobile-retailer
magasins téléphones mobile
mobile-retailer
boutiques téléphones portable
mobile-retailer
téléphones
mobile-retailer
magasin telephones mobile
mobile-retailer
boutique de téléphone cellulaire
mobile-retailer
boutiques téléphones mobile
mobile-retailer
téléphones mobiles
mobile-retailer
detaillant de telephones portables
mobile-retailer
détaillants téléphone portables
mobile-retailer
revendeur mobiles
mobile-retailer
magasin téléphones cellulaires
mobile-retailer
boutique de téléphones cellulaires
mobile-retailer
magasins téléphones portables
mobile-retailer
detaillants telephones mobile
mobile-retailer
telephone cellulaires
mobile-retailer
271
► API Reference
Query Term
Category
boutique de telephones portables
mobile-retailer
revendeurs mobiles
mobile-retailer
détaillant téléphones mobile
mobile-retailer
boutiques téléphones portables
mobile-retailer
détaillants de téléphones mobile
mobile-retailer
magasin téléphone mobile
mobile-retailer
magasin téléphones mobile
mobile-retailer
détaillant de téléphone mobile
mobile-retailer
mobiles
mobile-retailer
detaillant de telephones cellulaire
mobile-retailer
boutique de telephone cellulaire
mobile-retailer
boutique téléphone portable
mobile-retailer
detaillants de telephones mobile
mobile-retailer
boutique telephone portables
mobile-retailer
boutiques telephones cellulaires
mobile-retailer
détaillants téléphone portable
mobile-retailer
boutique téléphones cellulaire
mobile-retailer
magasin de telephones portables
mobile-retailer
détaillants téléphones cellulaire
mobile-retailer
magasins de telephones mobiles
mobile-retailer
magasin telephone mobiles
mobile-retailer
detaillant telephone cellulaires
mobile-retailer
boutique de telephones cellulaire
mobile-retailer
magasin téléphone portables
mobile-retailer
magasin telephone cellulaire
mobile-retailer
magasin de telephone cellulaire
mobile-retailer
boutique téléphone portables
mobile-retailer
magasin de telephones mobile
mobile-retailer
boutiques telephone portable
mobile-retailer
détaillants téléphone cellulaires
mobile-retailer
272
► API Reference
Query Term
Category
boutiques de telephone cellulaire
mobile-retailer
revendeur cellulaire
mobile-retailer
magasin telephones cellulaire
mobile-retailer
boutiques telephone mobiles
mobile-retailer
boutique de téléphones portables
mobile-retailer
detaillant telephone cellulaire
mobile-retailer
magasins de telephone
mobile-retailer
détaillant téléphone mobiles
mobile-retailer
detaillant telephone portable
mobile-retailer
boutique de telephones portable
mobile-retailer
téléphone mobile
mobile-retailer
magasins telephones portables
mobile-retailer
magasins telephone mobiles
mobile-retailer
réparation de téléphone mobile
mobile-service-center
services de telephonie mobile
centre de services de telephonie mobile
reparation de telephone mobile
centres de service de telephone mobile
service de téléphonie mobile
centres de service de téléphone mobile
centre de services de téléphonie mobile
service de telephonie mobile
services de téléphonie mobile
centre de service de téléphone mobile
centre de service mobile
centres de service mobile
centres de services de téléphonie mobile
centre de service de telephone mobile
centres de services de telephonie mobile
agences de mannequins
modeling-agencies
273
► API Reference
Query Term
Category
agence de mannequins
modeling-agencies
service de transfert d'argent
money-transferring-service
transferts d'argent
service de transfert l'argent
service transfert de l'argent
services transfert de l'argent
service de transfert de l'argent
service transfert d'argent
services de transfert l'argent
transfert l'argent
services transfert l'argent
transfert de l'argent
transfert d'argent
service transfert l'argent
services de transfert d'argent
transferts de l'argent
transferts l'argent
services de transfert de l'argent
services transfert d'argent
mosquée
mosque
mosquees
mosque
mosquées
mosque
mosquee
mosque
accessoires de moto
motorcycle-accessories
accessoires moto
accessoire de moto
accessoire moto
réparations de moto
motorcycle-service-and-maintenance
entretien de moto
reparation de moto
274
► API Reference
Query Term
Category
maintenance et entretien de la moto
mécano moto
service moto
reparations de moto
mecano moto
moto service
moto service et entretien
reparation de motocyclettes
entretien moto
maintenance et entretien de moto
réparation de motocyclettes
réparation de moto
demenageur
mover
déménageurs
mover
demenageurs
mover
déménageur
mover
film
movie
films
movie
music
music-workaround
boîtes de nuit
night-club
discotheques
night-club
boites de nuit
night-club
discothèque
night-club
discotheque
night-club
boîte de nuit
night-club
discothèques
night-club
boite de nuit
night-club
aide à la vie
nursing-home
maisons de soins infirmiers
nursing-home
soins infirmiers à domicile
nursing-home
275
► API Reference
Query Term
Category
soins infirmiers a domicile
nursing-home
aide a la vie
nursing-home
magasins bureau
office-supply-and-services-store
magasins fourniture papier
boutiques de fourniture de papier
boutiques de bureau
magasin de fourniture de stationnaire
boutique de fourniture bureau
shop fourniture stationnaire
magasin de bureau
fourniture papier
magasins fourniture de stationnaire
shops bureau
boutiques de fourniture papier
stationnaire
shop de fourniture bureau
magasins de fourniture de bureau
shops de fourniture bureau
shops de bureau
shops fourniture bureau
magasin de stationnaire
boutique de fourniture de stationnaire
magasin fourniture de stationnaire
magasin de fourniture de papier
magasin de fourniture bureau
shops de stationnaire
magasins de fourniture papier
shops de fourniture de stationnaire
magasins stationnaire
magasins de bureau
276
► API Reference
Query Term
Category
shops stationnaire
shops de fourniture stationnaire
boutique de fourniture papier
shop de fourniture stationnaire
magasin fourniture papier
shop de fourniture de stationnaire
boutiques de fourniture de bureau
boutiques fourniture de stationnaire
magasin fourniture stationnaire
shops de fourniture de papier
shops fourniture de stationnaire
boutique de bureau
shops de fourniture papier
papier
magasin fourniture de bureau
magasins fourniture stationnaire
boutiques fourniture stationnaire
magasins de fourniture de papier
shop fourniture de stationnaire
magasins papier
boutiques fourniture bureau
shop stationnaire
boutiques papier
boutique fourniture stationnaire
magasins de papier
boutique de stationnaire
shops de papier
boutiques de fourniture bureau
shop bureau
boutique fourniture papier
277
► API Reference
Query Term
Category
shops fourniture de papier
shop de bureau
shops papier
boutique stationnaire
magasin fourniture bureau
boutiques fourniture de papier
magasins de fourniture de stationnaire
magasins de fourniture bureau
shop fourniture papier
shop de fourniture papier
magasin stationnaire
boutique papier
magasins fourniture de papier
shop fourniture de bureau
magasin de fourniture papier
magasins de stationnaire
magasin fourniture de papier
boutique de fourniture de bureau
shops de fourniture de bureau
magasin papier
boutique de fourniture de papier
shop fourniture de papier
magasins fourniture de bureau
shops fourniture papier
boutique de fourniture stationnaire
shop de fourniture de papier
magasin bureau
magasin d'approvisionnements et services de bureau
boutiques bureau
fourniture de stationnaire
278
► API Reference
Query Term
Category
shop papier
fourniture stationnaire
shops fourniture stationnaire
fourniture de papier
shop de papier
magasins fourniture bureau
shops fourniture de bureau
articles de papeterie
shop fourniture bureau
shop de stationnaire
boutique bureau
shop de fourniture de bureau
fourniture de bureau
magasin de papier
fourniture bureau
papeterie
boutiques fourniture papier
boutique fourniture de bureau
magasins de fourniture stationnaire
boutiques de papier
magasin de fourniture de bureau
boutiques stationnaire
boutique fourniture de papier
boutiques de fourniture de stationnaire
boutique fourniture bureau
boutiques de fourniture stationnaire
magasin de fourniture stationnaire
boutiques de stationnaire
boutique fourniture de stationnaire
boutiques fourniture de bureau
279
► API Reference
Query Term
Category
boutique de papier
opticiens
optical
opticien
optical
magasin de peinture
paint-store
peinture
paint-store
magasin peinture
paint-store
magasins de peinture
paint-store
magasins peinture
paint-store
parcs de loisirs
parc de loisirs
loisirs
pâtes
pasta
pates
pasta
prêteurs sur gages
pawnshop
preteur sur gages
pawnshop
gages
pawnshop
prêteur sur gages
pawnshop
preteurs sur gages
pawnshop
soins pour animaux
pet-care
animaux tonte toilettage
pet-care
soins pour animaux de compagnie
pet-care
animaux tonte et toilettage
pet-care
soins animaux
pet-care
soins animaux de compagnie
pet-care
magasins de fournitures de bureau aquarium
pet-supply
magasins d'alimentation en aquarium
pet-supply
magasin d'alimentation pour animaux de compagnie
pet-supply
magasin d'aliments pour animaux de compagnie
pet-supply
magasin d'animaux de compagnie
pet-supply
magasin de fournitures d'aquarium
pet-supply
280
► API Reference
Query Term
Category
fournitures d'aquarium
pet-supply
magasins d'aliments pour animaux de compagnie
pet-supply
aquariophilie
pet-supply
accessoires pour animaux
pet-supply
boutique d'aquariums
pet-supply
fournitures pour animaux de compagnie
pet-supply
magasins de fournitures d'aquarium
pet-supply
animal de compagnie
pet-supply
aliment pour animaux familiers
pet-supply
aquarium fournitures de magasin
pet-supply
magasins d'animaux de compagnie
pet-supply
magasins d'aquarium
pet-supply
magasin de fournitures pour animaux de compagnie
pet-supply
animalerie
pet-supply
animaleries
pet-supply
magasin aquarium
pet-supply
alimentation pour animaux de compagnie
pet-supply
aquarium à poissons
pet-supply
magasins de fournitures aquarium
pet-supply
animaux de compagnie
pet-supply
materiel pour aquarium
pet-supply
aquarium a poissons
pet-supply
magasins d'alimentation pour animaux de compagnie
pet-supply
station d'essence
petrol-station
soupe repas vietnamienne
pho
soupe vietnamienne
pho
studios photographiques
photography
studio photo
photography
studios de photographie
photography
photos numériques
photography
281
► API Reference
Query Term
Category
studio photographique
photography
appareils photo
photography
appareils de photo
photography
photo numérique
photography
photographie
photography
photographique
photography
services photographiques
photography
photos numeriques
photography
photo numerique
photography
appareil de photo
photography
appareil photo
photography
magasin photo
photography
commissariats
police-station
commisariats
police-station
commissariat de police
police-station
commissariats de police
police-station
concessionnaire d'equipementet machines electriques
power-equipment-dealer
machines electriques
générateurs
generateurs
concessionnaire machines électriques
concessionnaire d'équipementet machines électriques
alternateurs
concessionnaire machines electriques
turbines
machines électriques
editeurs
printing-and-publishing
éditeurs
printing-and-publishing
etablissements d'incarceration
prison
établissements d'incarcération
prison
282
► API Reference
Query Term
Category
institut psychiatrique
psychiatric-institute
instituts psychiatriques
psychiatric-institute
aeroport sportive publique
aéroport de sportives publiques
aéroports sportives publiques
aéroport sportive publique
aeroport de sportives publiques
aérodrome
aerodrome
aérodromes
aéroports de sportives publiques
aerodromes
aeroports de sportives publiques
aeroports sportives publiques
acces transport en commun
public-transit-access
accès transport en commun
public-transit-access
pistes de course
race-track
piste de course
race-track
court de raquette
racket-ball-court
terrains raquette
racket-ball-court
salle de sports raquette
racket-ball-court
salles de sports raquette
racket-ball-court
courts raquette
racket-ball-court
terrains de raquette
racket-ball-court
terrain de raquette
racket-ball-court
courts de raquette
racket-ball-court
salle de sports de raquette
racket-ball-court
court raquette
racket-ball-court
terrain raquette
racket-ball-court
salles de sports de raquette
racket-ball-court
283
► API Reference
Query Term
Category
ferries rail
rail-ferry
ferry sur rail
rail-ferry
ferry rail
rail-ferry
ferries sur rail
rail-ferry
depot de locomotives
rail-yard
depot relais
rail-yard
dépôts relais
rail-yard
dépôt de locomotives
rail-yard
dépôts de locomotives
rail-yard
depots de locomotives
rail-yard
depots relais
rail-yard
dépôt relais
rail-yard
immobilier
real-estate-and-brokers
agent immobilier
realtor
agences immobilière
realtor
agence immobilière
realtor
etat reale
realtor
agence immobiliere
realtor
agences immobiliere
realtor
agents immobiliers
realtor
état reale
realtor
magasins de vidéo
record-cd-and-video
film
record-cd-and-video
magasins de film
record-cd-and-video
magasins de dvd
record-cd-and-video
videos
record-cd-and-video
magasins de disques
record-cd-and-video
films
record-cd-and-video
magasin de dvd
record-cd-and-video
magasin de videos
record-cd-and-video
284
► API Reference
Query Term
Category
vidéo
record-cd-and-video
magasin de disques
record-cd-and-video
magasins de video
record-cd-and-video
magasin de film
record-cd-and-video
magasin de vidéos
record-cd-and-video
video
record-cd-and-video
vidéos
record-cd-and-video
service de reparation et d'entretien
repair-and-maintenance-services
entretien et reparation
entretien et réparation
service de réparation et d'entretien
services de reparation
repair-service
service de réparation
repair-service
services de réparation
repair-service
service de reparation
repair-service
restaus
restaurant
restau
restaurant
resto
restaurant
restos
restaurant
assistance routiere
road-assistance
assistance routière
road-assistance
parc pour vr
rv-parks
parcs pour vr
rv-parks
terrains pour vr
rv-parks
terrains pour caravanes
rv-parks
parc pour caravane
rv-parks
terrains pour caravane
rv-parks
parcs pour caravane
rv-parks
parc pour caravanes
rv-parks
parcs pour caravanes
rv-parks
285
► API Reference
Query Term
Category
terrain pour caravane
rv-parks
terrain pour vr
rv-parks
terrain pour caravanes
rv-parks
musee des sciences
science-museum
musée des sciences
science-museum
musees des sciences
science-museum
musées des sciences
science-museum
poissons et fruits de mer
sea-food
magasins de chaussures
shoes-footwear
champs tir
shooting-range
gammes de pistolet
shooting-range
gamme pistolet
shooting-range
stands tir
shooting-range
stands de tir
shooting-range
champs de tir
shooting-range
sites d'intérêt et musées
sights-museums
sites d'interet et musees
sights-museums
station de ski
ski-resort
stations de ski
ski-resort
restaurant rapide
snacks-fast-food
terrain de foot
soccer-club
association foot
soccer-club
club foot
soccer-club
terrain de football
soccer-club
club de foot
soccer-club
club de football
soccer-club
terrain football
soccer-club
association de foot
soccer-club
association de football
soccer-club
terrain foot
soccer-club
286
► API Reference
Query Term
Category
club football
soccer-club
services sociaux
social-service
service social
social-service
espagnole
spanish
espagnol
spanish
espagnols
spanish
boutique de vêtements spécialisés
boutiques de vetements specialisees
boutiques de vêtements spécialisées
magasin de vetements specialises
magasins de vêtements spécialisés
magasins de vetements specialises
vêtements spécialisés
magasin de vêtements spécialisés
boutique de vetements specialises
vetements specialises
boutique de spécialités alimentaires
aliments de specialite
specialite culinaire
magasin d'alimentation specialisee
aliments de spécialité
magasins d'alimentation specialises
magasins d'alimentation spécialisés
magasin d'alimentation spécialisée
spécialité culinaire
boutique de specialites alimentaires
boutique specialisee
specialty-store
magasins spécialisés
specialty-store
boutiques spécialisées
specialty-store
boutiques specialisees
specialty-store
287
► API Reference
Query Term
Category
boutique spécialisée
specialty-store
magasins specialises
specialty-store
magasin spécialisé
specialty-store
magasin specialise
specialty-store
equipement sportif
sport-outdoor-shop
équipement sportif
sport-outdoor-shop
camps et enseignement sportif
sporting-instruction-and-camps
activite sportive
sports-activities
activité sportive
sports-activities
activites sportives
sports-activities
activités sportives
sports-activities
sports & plein air
sports et plein air
sport et plein air
sports et activités de plein air
sport & plein air
sports et activites de plein air
terrains de sport
sports-field
terrain de sport
sports-field
court squash
squash-court
terrains squash
squash-court
courts de squash
squash-court
terrain de squash
squash-court
salles squash
squash-court
courts squash
squash-court
salle de squash
squash-court
terrain squash
squash-court
court de squash
squash-court
salle squash
squash-court
de squash
squash-court
288
► API Reference
Query Term
Category
terrains de squash
squash-court
salles de squash
squash-court
self stockage
storage
stockage
storage
stockage public
storage
libre entreposage
storage
supermarche
supermarket
supermarché
supermarket
sushi
sushi
magasins de bonbons
sweet-shop
magasins de confiseries
sweet-shop
fondant
sweet-shop
boutique confiserie
sweet-shop
confiserie
sweet-shop
bonbons
sweet-shop
magasins de confiserie
sweet-shop
magasin de bonbons
sweet-shop
magasin de confiserie
sweet-shop
fondants
sweet-shop
confiseries
sweet-shop
bonbon
sweet-shop
suisses
swiss
synagogues juives
synagogue
synagogue juive
synagogue
couture altération
tailleurs
couture alteration
modification altération
tailleur et altérations
modification alteration
289
► API Reference
Query Term
Category
boutique d'altération
altérations
couturiers
atelier couture
couturieres
atelier de couture
tailleur et altération
magasins d'altération
magasins d'alteration
tailleur et alterations
couture
tailleur et alteration
couturière
tailleur
couturières
alterations
boutique d'alteration
couturiere
vente a emporter et livraison
take-out-and-delivery-only
livraison de nourriture
vente à emporter
vente a emporter
vente à emporter et livraison
livraison d'aliments
impots sur le revenu
tax-service
impôt trop payé
tax-service
impôts sur le revenu
tax-service
impôt
tax-service
conseiller fiscal
tax-service
impot trop paye
tax-service
290
► API Reference
Query Term
Category
conseillers fiscal
tax-service
remboursement fiscal
tax-service
conseil fiscal
tax-service
impot
tax-service
taxis
taxi
taxi
taxi
postes de taxi
taxi-stand
stand de taxis
taxi-stand
stands de taxis
taxi-stand
poste de taxi
taxi-stand
stations de taxis
taxi-stand
station de taxis
taxi-stand
maison de thé
tea
maison de the
tea
discount pneu
tires
services de pneu
tires
reparation de pneus
tires
pneus roues
tires
magasins de pneus
tires
roues et pneu
tires
roue pneu
tires
auto pneu
tires
roues
tires
roue pneumatique
tires
roues pneu
tires
réparation de pneus
tires
reparation de pneu
tires
réparation de pneu
tires
roues pneumatiques
tires
magasin de pneu
tires
291
► API Reference
Query Term
Category
pneu auto
tires
pneus auto
tires
magasin de pneus
tires
vente de pneu
tires
pneu service
tires
ventes de pneus
tires
roues pneus
tires
pneumatiques
tires
remises de pneu
tires
pneus services
tires
roue
tires
service pneus
tires
sites touristiques
tourist-attraction
syndicat dínitiative
tourist-information
traduction
translation-and-interpretation-services
services de traduction et d'interpretariat
services d'interprétariat
service de traduction
traducteur
service d'interprétariat
service de traduction et d'interpretariat
traducteurs
interprete
services de traduction et d'interprétariat
traductions
service d'interpretariat
service de traduction et d'interprétariat
interprète
services de traduction
service traduction
292
► API Reference
Query Term
Category
interpretes
interprètes
services d'interpretariat
services traduction
camions concessionnaires
truck-dealership
concessionnaire de camions
truck-dealership
concessionnaires de camions
truck-dealership
stationnement de camions
truck-parking
stationment pour camions
truck-parking
parking de camions
truck-parking
parking pour camions
truck-parking
stationment de camions
truck-parking
stationnement pour camions
truck-parking
réparation camions
truck-repair
garage camion
truck-repair
réparation camion
truck-repair
reparation de camions
truck-repair
réparation de camion
truck-repair
réparation de camions
truck-repair
garage camions
truck-repair
reparation de camion
truck-repair
reparation camions
truck-repair
reparation camion
truck-repair
arrêt camion
truck-stop-plaza
relais routiers
truck-stop-plaza
arret camion
truck-stop-plaza
arret de camion
truck-stop-plaza
arrêt de camion
truck-stop-plaza
levages de camions
truck-wash
levages camions
truck-wash
293
► API Reference
Query Term
Category
levage de camions
truck-wash
levage camions
truck-wash
seconde main
used-second-hand-merchandise-stores
boutique de seconde main
magasins revente
dépôt vente
brocante
magasin de seconde main
magasin de revente
revente
boutique seconde main
boutique revente
boutiques revente
boutiques seconde main
boutiques de seconde main
magasin revente
boutique de revente
boutiques de revente
depot vente
magasins seconde main
magasin seconde main
magasins de revente
magasins de seconde main
brocantes
gaz électricité
utilities
installation gaz
utilities
installation electrique
utilities
gaz electricite
utilities
installation électrique
utilities
reparations minibus
van-repair
294
► API Reference
Query Term
Category
réparations de van
van-repair
réparations van
van-repair
reparation van
van-repair
reparations de minibus
van-repair
réparations de minibus
van-repair
réparation de van
van-repair
reparations de van
van-repair
réparation minibus
van-repair
réparation de minibus
van-repair
reparation minibus
van-repair
réparations minibus
van-repair
reparation de van
van-repair
réparation van
van-repair
reparation de minibus
van-repair
reparations van
van-repair
magasins à prix uniques
variety-store
magasin populaires
variety-store
magasin de variété
variety-store
boutique populaire
variety-store
magasins populaire
variety-store
magasins de variété
variety-store
magasins a prix uniques
variety-store
boutiques populaires
variety-store
magasins variété
variety-store
boutique populaires
variety-store
boutiques a prix uniques
variety-store
boutique de variété
variety-store
boutique de variete
variety-store
magasin de variete
variety-store
boutiques à prix uniques
variety-store
295
► API Reference
Query Term
Category
magasins de variete
variety-store
boutique variete
variety-store
magasin variete
variety-store
magasin à prix uniques
variety-store
boutiques variete
variety-store
boutique à prix uniques
variety-store
magasins variete
variety-store
boutique a prix uniques
variety-store
boutiques variété
variety-store
magasins populaires
variety-store
boutiques de variete
variety-store
boutiques populaire
variety-store
boutique variété
variety-store
magasin populaire
variety-store
magasin variété
variety-store
boutiques de variété
variety-store
magasin a prix uniques
variety-store
végétalienne
vegan
veganiste
vegan
véganes
vegan
cuisine véganiste
vegan
alimentation véganiste
vegan
vegane
vegan
veganes
vegan
végane
vegan
restaurants vegetaliennes
vegan
alimentation végétalienne
vegan
restaurant vegane
vegan
cuisine veganiste
vegan
alimentation vegetalienne
vegan
296
► API Reference
Query Term
Category
cuisine vegane
vegan
restaurants végétaliennes
vegan
restaurant veganiste
vegan
cuisine végétalienne
vegan
alimentation vegane
vegan
végétaliens
vegan
végétalien
vegan
restaurant végétalienne
vegan
cuisine végane
vegan
véganistes
vegan
restaurant vegetalienne
vegan
alimentation veganiste
vegan
veganistes
vegan
restaurant végane
vegan
vegetaliens
vegan
restaurants veganes
vegan
restaurant véganiste
vegan
restaurants véganes
vegan
cuisine vegetalienne
vegan
restaurants veganistes
vegan
alimentation végane
vegan
vegetalien
vegan
vegetalienne
vegan
véganiste
vegan
végétaliennes
vegan
restaurants véganistes
vegan
vegetaliennes
vegan
location de jeux video
video-and-game-rental
location de jeu
location de jeux vidéo
297
► API Reference
Query Term
Category
videos
location de vidéo et de jeu
location de dvd
jeux vidéo
vidéo
location de video et de jeu
location de jeux
location de videos
jeu vidéo
location de films
location de vidéos
jeu video
video
vidéos
jeux video
jeux vidéo
video-arcade-game-room
jeu vidéo
jeu video
salle de jeux arcade
salles de jeux d'arcade
jeux video
dechets et sanitaires
waste-and-sanitary
déchets
waste-and-sanitary
déchets et sanitaires
waste-and-sanitary
gestion des déchets
waste-and-sanitary
recyclage
waste-and-sanitary
gestion des dechets
waste-and-sanitary
dechets
waste-and-sanitary
sports déau
water-sport
transits de l'eau
water-transit
298
► API Reference
Query Term
Category
transit de l'eau
water-transit
chutes d'eau
waterfall
chute d'eau
waterfall
services de mariage et de mariee studios
wedding-services-and-bridal-studio
service de mariage
mariée studios
mariée studio
services de mariage
studio nuptiales
mode nuptiale
mariee studio
service mariage
services de mariage et de mariée studios
studio nuptiale
boutiques nuptiales
services mariage
mariee studios
boutiques nuptiale
services de mariage et studio nuptiale
bridal boutique
mode nuptiales
station de pesage
weigh-station
stations de pesage
weigh-station
bien être
wellness
bien etre
wellness
parcs animaux sauvage
wild-animal-park
parcs animaux sauvages
wild-animal-park
parc animalier sauvages
wild-animal-park
parc animaux sauvages
wild-animal-park
parc animaux sauvage
wild-animal-park
299
► API Reference
Query Term
Category
parcs animalier sauvages
wild-animal-park
parcs animalier sauvage
wild-animal-park
parc animalier sauvage
wild-animal-park
sanctuaire
wildlife-refuge
reserve faunique
wildlife-refuge
sanctuaires fauniques
wildlife-refuge
reserve fauniques
wildlife-refuge
réserve faunique
wildlife-refuge
réserves faunique
wildlife-refuge
reserves faunique
wildlife-refuge
réserves fauniques
wildlife-refuge
sanctuaire faunique
wildlife-refuge
refuges fauniques
wildlife-refuge
refuge faunique
wildlife-refuge
refuge fauniques
wildlife-refuge
sanctuaire fauniques
wildlife-refuge
sanctuaires faunique
wildlife-refuge
refuges faunique
wildlife-refuge
sanctuaire de faune
wildlife-refuge
reserves fauniques
wildlife-refuge
réserve fauniques
wildlife-refuge
vins et spiritueux
wine-and-liquor
domaine viticole
winery
domaines viticoles
winery
boutique de mode femmes
womens-apparel
magasin vêtements femmes
womens-apparel
boutiques de mode femmes
womens-apparel
boutiques vêtements pour femmes
womens-apparel
vêtements pour femmes
womens-apparel
boutiques de vetements pour femmes
womens-apparel
300
► API Reference
Query Term
Category
boutiques mode feminine
womens-apparel
vetements pour femmes
womens-apparel
magasins vêtements féminins
womens-apparel
boutiques de vêtements femmes
womens-apparel
boutique de vêtements féminins
womens-apparel
boutique mode pour femmes
womens-apparel
magasins vetements feminins
womens-apparel
magasin mode pour femmes
womens-apparel
magasin de mode femmes
womens-apparel
boutique vêtements féminins
womens-apparel
magasin vêtements pour femmes
womens-apparel
magasin vetements feminins
womens-apparel
magasins de vêtements femmes
womens-apparel
mode femmes
womens-apparel
magasins de vetements feminins
womens-apparel
boutique mode féminine
womens-apparel
magasins de mode féminine
womens-apparel
boutique de mode pour femmes
womens-apparel
magasin de vêtements pour femmes
womens-apparel
boutique de vetements feminins
womens-apparel
magasins de vêtements pour femmes
womens-apparel
boutique vêtements pour femmes
womens-apparel
boutique vêtements femmes
womens-apparel
boutiques vêtements féminins
womens-apparel
magasins de mode feminine
womens-apparel
magasin vetements pour femmes
womens-apparel
magasin de vêtements féminins
womens-apparel
magasin mode féminine
womens-apparel
magasin mode feminine
womens-apparel
magasins de mode pour femmes
womens-apparel
301
► API Reference
Query Term
Category
magasins de mode femmes
womens-apparel
magasins vêtements femmes
womens-apparel
vêtements femmes
womens-apparel
magasins mode féminine
womens-apparel
boutiques de mode pour femmes
womens-apparel
magasin mode femmes
womens-apparel
magasin de mode feminine
womens-apparel
magasins mode pour femmes
womens-apparel
boutique de mode féminine
womens-apparel
mode pour femmes
womens-apparel
magasins de vetements pour femmes
womens-apparel
magasins vêtements pour femmes
womens-apparel
magasin de vetements femmes
womens-apparel
boutique de vêtements femmes
womens-apparel
mode féminine
womens-apparel
mode feminine
womens-apparel
vetements femmes
womens-apparel
boutiques mode pour femmes
womens-apparel
magasin de vêtements femmes
womens-apparel
boutiques de vetements feminins
womens-apparel
boutique mode femmes
womens-apparel
boutiques de vêtements féminins
womens-apparel
boutiques mode féminine
womens-apparel
boutique vetements pour femmes
womens-apparel
magasin vetements femmes
womens-apparel
boutiques vetements feminins
womens-apparel
boutique vetements femmes
womens-apparel
magasin de mode féminine
womens-apparel
magasin vêtements féminins
womens-apparel
boutique de vetements femmes
womens-apparel
302
► API Reference
Query Term
Category
magasin de vetements pour femmes
womens-apparel
magasin de vetements feminins
womens-apparel
boutiques vetements femmes
womens-apparel
boutique de vetements pour femmes
womens-apparel
boutiques de mode féminine
womens-apparel
boutique mode feminine
womens-apparel
boutiques de vêtements pour femmes
womens-apparel
magasins de vêtements féminins
womens-apparel
boutique vetements feminins
womens-apparel
boutiques de vetements femmes
womens-apparel
magasins mode femmes
womens-apparel
boutiques vetements pour femmes
womens-apparel
boutiques de mode feminine
womens-apparel
magasins vetements femmes
womens-apparel
boutiques mode femmes
womens-apparel
boutique de mode feminine
womens-apparel
magasin de mode pour femmes
womens-apparel
magasins de vetements femmes
womens-apparel
magasins mode feminine
womens-apparel
boutique de vêtements pour femmes
womens-apparel
boutiques vêtements femmes
womens-apparel
magasins vetements pour femmes
womens-apparel
ports de plaisance
yacht-basin
jardins zoologiques
zoo
parc zoologique
zoo
parc zoologiques
zoo
List of Supported Spanish Category-like Query Terms
Query Term
Category
hospedaje
accommodation
303
► API Reference
Query Term
Category
erotica
adult-entertainment
erótica
adult-entertainment
erotica
adult-shop
erótica
adult-shop
sex toy
adult-shop
sex toys
adult-shop
servicio de emergencia medica
ambulance-services
servicio de emergencia médica
ambulance-services
ciudad de hierro
amusement-park
ciudades de hierro
amusement-park
firmas de abogados
attorney
club de automovil
automobile-club
club de automóvil
automobile-club
clubes de automovil
automobile-club
clubes de automóvil
automobile-club
clubes de automoviles
automobile-club
clubes de automóviles
automobile-club
coche nuevo
coches nuevos
concesionario de coches nuevos
concesionarios de coches nuevos
coches usados
concesionario de coches usados
concesionarios de coches usados
campo de baloncesto
basketball
campo de basquetbol
basketball
campo de básquetbol
basketball
campos de baloncesto
basketball
campos de basquetbol
basketball
campos de básquetbol
basketball
304
► API Reference
Query Term
Category
cerveza
beer
cervezas
beer
cuerpo de agua
body-of-water
estudio de tattoo
estudios de tattoo
tatuajes
libro
bookshop
tienda de libros
bookshop
tiendas de libros
bookshop
autobus
bus-terminal
autobús
bus-terminal
autobuses
bus-terminal
estación de autobuses
bus-terminal
estaciones de autobus
bus-terminal
estaciones de autobús
bus-terminal
estaciones terminales de buses
bus-terminal
terminal de ómnibus
bus-terminal
terminales de omnibus
bus-terminal
terminales de ómnibus
bus-terminal
acampamentos
camping
campamento de turismo
camping
campamentos
camping
campamentos de turismo
camping
automovil
car
automóvil
car
automoviles
car
automóviles
car
coche
car
coches
car
concesionario
car-dealer
305
► API Reference
Query Term
Category
concesionarios
car-dealer
vendedor de coches
car-dealer
vendedores de coches
car-dealer
venta de automoviles
car-dealer
venta de automóviles
car-dealer
venta de coches
car-dealer
casa de juego
casino
casas de juego
casino
casino de juego
casino
casinos de juego
casino
confeccion para ninos
childrens-apparel
confección para niños
childrens-apparel
empresa de confeccion para ninos
childrens-apparel
empresa de confección para niños
childrens-apparel
empresas de confeccion para ninos
childrens-apparel
empresas de confección para niños
childrens-apparel
tienda de confeccion para ninos
childrens-apparel
tienda de confección para niños
childrens-apparel
tiendas de confeccion para ninos
childrens-apparel
tiendas de confección para niños
childrens-apparel
empresa de confeccion
clothing
empresa de confección
clothing
empresas de confeccion
clothing
empresas de confección
clothing
tienda de confeccion
clothing
tienda de confección
clothing
tiendas de confeccion
clothing
tiendas de confección
clothing
centro cultural
community-centre
centros culturales
community-centre
306
► API Reference
Query Term
Category
cercanias
cercanías
estacion de cercanias
estación de cercanías
estacion de trenes de cercanias
estación de trenes de cercanías
estaciones de cercanias
estaciones de cercanías
tren de cercanias
tren de cercanías
trenes de cercanias
trenes de cercanías
consulado
consulate
consulados
consulate
electronica de consumo
electrónica de consumo
tienda de conveniencia
convenience-store
tiendas de conveniencia
convenience-store
tribunal de justicia
courthouse
tribunales de justicia
courthouse
clinica dental
dentist
clínica dental
dentist
clinicas dentales
dentist
clínicas dentales
dentist
tienda de descuento
discount-store
tiendas de descuento
discount-store
bucear
diving-centre
buceo
diving-centre
limpieza seco
dry-cleaning
limpiezas seco
dry-cleaning
307
► API Reference
Query Term
Category
centros educativos
education-facility
tienda de electronicas
electronics-shop
tienda de electrónicas
electronics-shop
tienda electronica
electronics-shop
tienda electrónica
electronics-shop
tiendas de electronicas
electronics-shop
tiendas de electrónicas
electronics-shop
tiendas electronicas
electronics-shop
tiendas electrónicas
electronics-shop
embajada
embassy
embajadas
embassy
centros de exhibicion
exhibition-centre
centros de exhibición
exhibition-centre
ferri
ferry
ferris
ferry
estanciones de ferry
ferry-terminal
terminales de ferris
ferry-terminal
transbordador
ferry
transbordadores
ferry
departamento de bomberos
fire-department
departamentos de bomberos
fire-department
estacion de bomberos
fire-department
estación de bomberos
fire-department
estaciones de bomberos
fire-department
gimnasio
fitness-health-club
gimnasios
fitness-health-club
alimento
food
director de pompas funebres
funeral-director
director de pompas fúnebres
funeral-director
directores de pompas funebres
funeral-director
308
► API Reference
Query Term
Category
directores de pompas fúnebres
funeral-director
directores funerarios
funeral-director
director funerario
funeral-director
empresa de pompas funebres
funeral-director
empresa de pompas fúnebres
funeral-director
empresas de pompas funebres
funeral-director
empresas de pompas fúnebres
funeral-director
funeraria
funeral-director
funerarias
funeral-director
pompas funebres
funeral-director
pompas fúnebres
funeral-director
mobiliario
furniture-store
mobiliarios
furniture-store
mueble
furniture-store
muebleria
furniture-store
mueblería
furniture-store
mueblerias
furniture-store
mueblerías
furniture-store
muebles
furniture-store
tienda de muebles
furniture-store
tiendas de muebles
furniture-store
galeria de arte
gallery
galería de arte
gallery
centro de jardineria
garden-center
centro de jardinería
garden-center
centros de jardineria
garden-center
centros de jardinería
garden-center
minorista
general-merchandise
tienda de regalos
tiendas de regalos
309
► API Reference
Query Term
Category
canchas de golf
golf-course
club de golf
golf-course
clubes de golf
golf-course
golf
golf
abaceria
grocery
abacería
grocery
abacerias
grocery
abacerías
grocery
colmado
grocery
colmados
grocery
pulperia
grocery
pulpería
grocery
pulperias
grocery
pulperías
grocery
tienda de ultramarinos
grocery
tiendas de ultramarinos
grocery
monumento historico
historical-monument
monumento histórico
historical-monument
hockey sobre hielo
hockey
ferreteria
ferretería
ferreterias
ferreterías
tienda de materiales de construccion
tienda de materiales de construcción
tiendas de materiales de construccion
tiendas de materiales de construcción
asistencia sanitaria
hostales
hostel
agencia de colocacion
310
► API Reference
Query Term
Category
agencia de colocación
agencias de colocacion
agencias de colocación
empresa de trabajo temporal
empresas de trabajo temporal
oficina de colocacion
oficina de colocación
oficinas de colocacion
oficinas de colocación
servicio de colocacion
servicio de colocación
servicios de colocacion
servicios de colocación
trabajo temporal
tramitacion de trabajo
tramitación de trabajo
areas industriales
industrial-area
áreas industriales
industrial-area
parque industrial
industrial-area
parques industriales
industrial-area
aeropuerto internacional
aeropuertos internacionales
cibercafe
internet-cafe
cibercafé
internet-cafe
cibercafes
internet-cafe
cibercafés
internet-cafe
locutorio
internet-cafe
locutorios
internet-cafe
musica de jazz
jazz-club
música de jazz
jazz-club
311
► API Reference
Query Term
Category
karaoke
karaoke
educacion preescolar
kindergarten
educación preescolar
kindergarten
jardin de infancia
kindergarten
jardín de infancia
kindergarten
jardin de infantes
kindergarten
jardín de infantes
kindergarten
jardin de ninos
kindergarten
jardín de niños
kindergarten
jardines de infancia
kindergarten
jardines de infantes
kindergarten
jardines de ninos
kindergarten
jardines de niños
kindergarten
parvulario
kindergarten
parvularios
kindergarten
atracciones turisticas
landmark-attraction
atracciones turísticas
landmark-attraction
atraccion turistica
landmark-attraction
atracción turística
landmark-attraction
lugar de interes
landmark-attraction
lugar de interés
landmark-attraction
servicio de lavanderia
laundry
servicio de lavandería
laundry
servicios de lavanderia
laundry
servicios de lavandería
laundry
libro
library
cerrajeria
cerrajería
cerrajerias
cerrajerías
312
► API Reference
Query Term
Category
servicio de cerrajeria
servicio de cerrajería
servicios de cerrajeria
servicios de cerrajería
loteria
lottery-booth
lotería
lottery-booth
loterias
lottery-booth
loterías
lottery-booth
loterias y apuestas del estado
lottery-booth
loterías y apuestas del estado
lottery-booth
centros de compras
mall
mercado
market
mercados
market
camiseria
mens-apparel
camisería
mens-apparel
camiserias
mens-apparel
camiserías
mens-apparel
moda masculina
mens-apparel
ropa de caballero
mens-apparel
tienda de moda masculina
mens-apparel
tienda de moda para caballeros
mens-apparel
tienda de ropa de caballero
mens-apparel
tienda de ropa de caballeros
mens-apparel
tiendas de moda masculina
mens-apparel
tiendas de moda para caballeros
mens-apparel
tiendas de ropa de caballero
mens-apparel
tiendas de ropa de caballeros
mens-apparel
celular
mobile-retailer
celulares
mobile-retailer
telefono celular
mobile-retailer
313
► API Reference
Query Term
Category
teléfono celular
mobile-retailer
telefono movil
mobile-retailer
teléfono móvil
mobile-retailer
telefono portatil
mobile-retailer
teléfono portátil
mobile-retailer
telefonos celulares
mobile-retailer
teléfonos celulares
mobile-retailer
telefonos moviles
mobile-retailer
teléfonos móviles
mobile-retailer
telefonos portatiles
mobile-retailer
teléfonos portátiles
mobile-retailer
mezquita
mosque
mezquitas
mosque
concesionario de motocicletas
motorcycle-dealer
concesionario motocicletas
motorcycle-dealer
concesionarios de motocicletas
motorcycle-dealer
concesionarios motocicletas
motorcycle-dealer
moto
motorcycle-dealer
motos
motorcycle-dealer
tienda de motocicletas
motorcycle-dealer
tienda motocicletas
motorcycle-dealer
tiendas de motocicletas
motorcycle-dealer
tiendas motocicletas
motorcycle-dealer
arreglo de motocicletas
arreglo motocicletas
arreglos de motocicletas
arreglos motocicletas
reparacion de motocicletas
reparación de motocicletas
reparaciones de motocicletas
314
► API Reference
Query Term
Category
reparaciónes de motocicletas
reparaciones motocicletas
reparaciónes motocicletas
reparacion motocicletas
reparación motocicletas
taller de motocicletas
talleres de motocicletas
talleres motocicletas
taller motocicletas
clubes nocturnos
night-club
club nocturno
night-club
ancianato
nursing-home
ancianatos
nursing-home
asilo de ancianos
nursing-home
asilos de ancianos
nursing-home
hogar de retiro
nursing-home
hogares de retiro
nursing-home
residencia de ancianos
nursing-home
residencia para ancianos
nursing-home
residencia para la tercera edad
nursing-home
residencias de ancianos
nursing-home
residencias para ancianos
nursing-home
residencias para la tercera edad
nursing-home
papeleria
papelería
papelerias
papelerías
optica
optical
óptica
optical
opticas
optical
315
► API Reference
Query Term
Category
ópticas
optical
optico
optical
óptico
optical
opticos
optical
ópticos
optical
pintureria
paint-store
pinturería
paint-store
pinturerias
paint-store
pinturerías
paint-store
aparcamiento
parking
aparcamiento abierto
parking
aparcamientos
parking
aparcamientos abiertos
parking
area de estacionamiento abierta
parking
área de estacionamiento abierta
parking
estacionamientos
parking
garajes de estacionamiento
parking-garage
parkings
parking
parqueadero
parking
parqueaderos
parking
parquin
parking
parquins
parking
gasolineria
petrol-station
gasolinería
petrol-station
gasolinerias
petrol-station
gasolinerías
petrol-station
pajareria
pet-supply
pajarería
pet-supply
pajarerias
pet-supply
pajarerías
pet-supply
316
► API Reference
Query Term
Category
tienda de animales
pet-supply
tienda de animales domesticos
pet-supply
tienda de animales domésticos
pet-supply
tiendas de animales
pet-supply
tiendas de animales domesticos
pet-supply
tiendas de animales domésticos
pet-supply
botica
pharmacy
boticas
pharmacy
oficina de farmacia
pharmacy
oficina farmacia
pharmacy
oficinas de farmacia
pharmacy
oficinas farmacia
pharmacy
estudio fotografico
photography
estudio fotográfico
photography
estudios fotograficos
photography
estudios fotográficos
photography
fotografia
photography
fotografía
photography
fotografias
photography
fotografías
photography
fotografico
photography
fotográfico
photography
fotograficos
photography
fotográficos
photography
fotografo
photography
fotógrafo
photography
fotografos
photography
fotógrafos
photography
aeropuerto deportivo
circuito de carreras
race-track
317
► API Reference
Query Term
Category
circuitos de carreras
race-track
transbordador de trenes
rail-ferry
transbordadores de trenes
rail-ferry
inmobiliaria
inmobiliarias
propiedades inmobiliarias
propiedad inmobiliaria
agencia inmobiliaria
realtor
agencias inmobiliarias
realtor
agente de la propiedad inmobiliaria
realtor
agente inmobiliario
realtor
agentes de la propiedad inmobiliaria
realtor
agentes inmobiliarios
realtor
area de reposo
rest-area
área de reposo
rest-area
areas de reposo
rest-area
áreas de reposo
rest-area
barraca de tiro
shooting-range
barraca de tiro al blanco
shooting-range
barracas de tiro
shooting-range
barracas de tiro al blanco
shooting-range
campo de tiro
shooting-range
campos de tiro
shooting-range
caseta de tiro
shooting-range
caseta de tiro al blanco
shooting-range
casetas de tiro
shooting-range
casetas de tiro al blanco
shooting-range
estacion de esqui
ski-resort
estación de esquí
ski-resort
club de futbol
soccer-club
318
► API Reference
Query Term
Category
club de fútbol
soccer-club
clubes de futbol
soccer-club
clubes de fútbol
soccer-club
futbol
soccer-club
fútbol
soccer-club
tienda de articulos deportivos
sport-outdoor-shop
tienda de artículos deportivos
sport-outdoor-shop
tiendas de articulos deportivos
sport-outdoor-shop
tiendas de artículos deportivos
sport-outdoor-shop
instalacion deportiva
instalación deportiva
instalaciones deportivas
campo de deportes
sports-field
campos de deportes
sports-field
cancha de deportes
sports-field
canchas de deportes
sports-field
bomboneria
sweet-shop
bombonería
sweet-shop
bombonerias
sweet-shop
bombonerías
sweet-shop
confiteria
sweet-shop
confitería
sweet-shop
confiterias
sweet-shop
confiterías
sweet-shop
dulceria
sweet-shop
dulcería
sweet-shop
dulcerias
sweet-shop
dulcerías
sweet-shop
pileta
swimming-pool
pileta de natacion
swimming-pool
319
► API Reference
Query Term
Category
pileta de natación
swimming-pool
piletas
swimming-pool
piletas de natacion
swimming-pool
piletas de natación
swimming-pool
sinagoga
synagogue
sinagogas
synagogue
cortador
cortadores
guarnecedor
guarnecedores
modista
modistas
modisto
modistos
sastra
sastras
sastre
sastreria
sastrería
sastrerias
sastrerías
sastres
asesores fiscales
tax-service
asesor fiscal
tax-service
salon de te
tea
salon de té
tea
salones de te
tea
salones de té
tea
teteria
tea
tetería
tea
320
► API Reference
Query Term
Category
teterias
tea
teterías
tea
canchas de tenis
tennis-court
cambio de rueda
tires
cambio de ruedas
tires
neumatico
tires
neumático
tires
neumaticos
tires
neumáticos
tires
informaciones turisticas
tourist-information
informaciones turísticas
tourist-information
remolque
towing-service
remolques
towing-service
servicios de remolque
towing-service
servicios tecnicos de grua
towing-service
servicios técnicos de grúa
towing-service
traductor
traductores
estacion de subte
underground-station
estación de subte
underground-station
estaciones de subte
underground-station
subte
underground-station
segunda mano
clinicas veterinarias
veterinarian
clínicas veterinarias
veterinarian
clinica veterinaria
veterinarian
clínica veterinaria
veterinarian
veterinaria
veterinarian
veterinarias
veterinarian
videoclub
321
► API Reference
Query Term
Category
videoclubes
salones recreativos
salon recreativo
salón recreativo
licorerías
wine-and-liquor
bodega
winery
moda femenina
womens-apparel
ropa de dama
womens-apparel
ropa de damas
womens-apparel
ropa de mujer
womens-apparel
ropa de mujeres
womens-apparel
tienda de moda femenina
womens-apparel
tienda de ropa de damas
womens-apparel
tienda de ropa de mujer
womens-apparel
tienda de ropa de mujeres
womens-apparel
tiendas de moda femenina
womens-apparel
tiendas de ropa de damas
womens-apparel
tiendas de ropa de mujer
womens-apparel
tiendas de ropa de mujeres
womens-apparel
puerto deportivo
yacht-basin
jardines zoologicos
zoo
jardínes zoológicos
zoo
jardin zoologico
zoo
jardín zoológico
zoo
List of Supported Italian Category-like Query Terms
Query Term
Category
alloggi
accommodation
alloggiamenti
accommodation
alloggiamento
accommodation
322
► API Reference
Query Term
Category
sex-shop
adult-shop
agenzia pubblicitaria
agenzie pubblicitaria
servizi ambulanza
ambulance-services
servizi medichi di emergenza sanitaria
ambulance-services
servizio ambulanza
ambulance-services
servizio di ambulanza
ambulance-services
servizio medico di emergenza sanitaria
ambulance-services
lunaparchi
amusement-park
lunapark
amusement-park
parchi a tema
amusement-park
parchi di divertimenti
amusement-park
parchi di divertimento
amusement-park
parchi divertimento
amusement-park
parco di divertimenti
amusement-park
parco divertimento
amusement-park
abitazione
appartamenti
appartamento
musei arte
art-museum
musei d'arte
art-museum
museo arte
art-museum
sportelli automatichi
atm
sportello automatico
atm
avvocati
attorney
studi legale
attorney
badminton
badminton
birreria
bar-pub
birrerie
bar-pub
basket
basketball
323
► API Reference
Query Term
Category
alloggio e prima colazione
bed-and-breakfast
camera con colazione
bed-and-breakfast
pensione
bed-and-breakfast
birra
beer
birre
beer
negozi di bici
negozi di biciclette
negozio di bici
negozio di biciclette
bici
bicycle
biciclette
bicycle
riparazione bici
riparazione biciclette
riparazione di bici
riparazione di biciclette
corpo d'acqua
body-of-water
autostazioni
bus-terminal
stazione autobus
bus-terminal
stazioni autocorriere
bus-terminal
automobile
car
autovettura
car
autovetture
car
concessionaria
car-dealer
concessionaria auto
car-dealer
concessionaria d'auto
car-dealer
concessionarie
car-dealer
concessionarie auto
car-dealer
concessionarie d'auto
car-dealer
venditore d'automobili
car-dealer
macchina
car
324
► API Reference
Query Term
Category
macchine
car
noleggi auto
car-rental
noleggio auto
car-rental
autofficina
car-repair
autofficina di riparazioni
car-repair
autofficine
car-repair
autofficine di riparazioni
car-repair
autorimessa
car-repair
autorimesse
car-repair
carrozzeria
car-repair
carrozzerie
car-repair
riparazione auto
car-repair
riparazione macchina
car-repair
riparazione macchine
car-repair
riparazioni auto
car-repair
riparazioni macchina
car-repair
riparazioni macchine
car-repair
casa da gioco
casino
case da gioco
casino
abbigliamenti bambini
childrens-apparel
abbigliamenti bambino
childrens-apparel
abbigliamenti da bambini
childrens-apparel
abbigliamenti da bambino
childrens-apparel
abbigliamenti per bambini
childrens-apparel
abbigliamenti per bambino
childrens-apparel
abbigliamento bambini
childrens-apparel
abbigliamento bambino
childrens-apparel
abbigliamento da bambini
childrens-apparel
abbigliamento da bambino
childrens-apparel
abbigliamento per bambini
childrens-apparel
325
► API Reference
Query Term
Category
abbigliamento per bambino
childrens-apparel
sale cinematografiche
cinema
abbigliamenti
clothing
negozi abbigliamento
clothing
negozi di abbigliamento
clothing
negozi di vestiti
clothing
negozio abbigliamento
clothing
negozio di abbigliamento
clothing
negozio di vestiti
clothing
negozio vestiti
clothing
negozi vestiti
clothing
caffetteria
coffee
caffetterie
coffee
servizio ferroviario suburbano
stazione di mezzi regionali
costruzione
construction
consolati
consulate
consolato
consulate
elettronica di consumo
negozio per elettronica
negozio per elettronica di consumo
negozi per elettronica
negozi per elettronica di consumo
scuola di ballo
dancing
scuole di ballo
dancing
odontoiatra
dentist
odontoiatri
dentist
discount
discount-store
centri immersioni
diving-centre
centro immersioni
diving-centre
326
► API Reference
Query Term
Category
dive center
diving-centre
dive centers
diving-centre
diving center
diving-centre
diving centers
diving-centre
immersione
diving-centre
immersione subacquea
diving-centre
scuba
diving-centre
subacquea
diving-centre
medici di base
doctor
medici di famiglia
doctor
medici di medicina generale
doctor
medici generici
doctor
medico di base
doctor
medico di medicina generale
doctor
medico generico
doctor
drogheria
drug-store
drogherie
drug-store
lavaggio a secco
dry-cleaning
pulitura a secco
dry-cleaning
educazione
education-facility
negozi di elettronica
electronics-shop
negozio di elettronica
electronics-shop
ambasciata
embassy
ambasciate
embassy
prova di emissione
emission-testing
prove di emissione
emission-testing
centri congressi
centro congressi
traghetti
ferry
traghetto
ferry
327
► API Reference
Query Term
Category
cucina raffinata
fine-dining
fitness-health-club
centri di fitness
centro di fitness
fitness-health-club
becchini
funeral-director
becchino
funeral-director
impresa di pompe funebri
funeral-director
imprese di pompe funebri
funeral-director
necrofori
funeral-director
necroforo
funeral-director
pompe funebri
funeral-director
arredamento
furniture-store
mobili
furniture-store
mobilia
furniture-store
negozi di mobili
furniture-store
negozi mobili
furniture-store
negozio di mobili
furniture-store
negozio mobili
furniture-store
galleria d'arte
gallery
vendita al dettaglio
general-merchandise
vetreria
glass-and-window
vetrerie
glass-and-window
golf
golf
alimentari
grocery
cibaria
grocery
foresteria
guest-house
foresterie
guest-house
edificio storico
historical-monument
musei di storia
history-museum
museo di storia
history-museum
hockey su ghiaccio
hockey
328
► API Reference
Query Term
Category
bricolage
centri fai-da te
centro fai-da te
fai da te
ferramenta
mercati dell'edilizia
mercato dell'edilizia
negozi di ferramenta
negozio di ferramenta
assistenza sanitaria
agenzia per il lavoro
agenzie per il lavoro
collocamento
mediazione di lavoro
uffici collocamento
uffici di collocamento
ufficio collocamento
ufficio di collocamento
pattinaggio
ice-skating
pista di pattinaggio
ice-skating
piste di pattinaggio
ice-skating
zona industriale
industrial-area
zone industriale
industrial-area
aeroporti internazionali
aeroporto internazionale
internet cafe
internet-cafe
internet café
internet-cafe
internet point
internet-cafe
asili di infanzia
kindergarten
asili d'infanzia
kindergarten
329
► API Reference
Query Term
Category
asili infantili
kindergarten
asili nido
kindergarten
asilo di infanzia
kindergarten
asilo d'infanzia
kindergarten
asilo infantile
kindergarten
asilo nido
kindergarten
giardini di infanzia
kindergarten
giardini d'infanzia
kindergarten
giardino di infanzia
kindergarten
giardino d'infanzia
kindergarten
scuola dell'infanzia
kindergarten
scuola materna
kindergarten
scuole dell'infanzia
kindergarten
scuole materne
kindergarten
lavanderia a gettone
laundry
lavanderie a gettone
laundry
servizi duplicazioni chiavi
servizio duplicazioni chiavi
mercati
market
mercato
market
abbigliamento da uomo
mens-apparel
abbigliamento maschile
mens-apparel
abbigliamento per uomo
mens-apparel
negozi d'abbigliamento da uomo
mens-apparel
negozi d'abbigliamento maschile
mens-apparel
negozi d'abbigliamento per uomo
mens-apparel
negozio d'abbigliamento da uomo
mens-apparel
negozio d'abbigliamento maschile
mens-apparel
negozio d'abbigliamento per uomo
mens-apparel
cellulare
mobile-retailer
330
► API Reference
Query Term
Category
cellulari
mobile-retailer
telefoni cellulari
mobile-retailer
telefonini
mobile-retailer
telefonino
mobile-retailer
telefono cellulare
mobile-retailer
moschea
mosque
moschee
mosque
moto
motorcycle-dealer
motocicletta
motorcycle-dealer
motociclette
motorcycle-dealer
motocicli
motorcycle-dealer
motociclo
motorcycle-dealer
officina di moto
officina di riparazioni moto
officina di riparazioni per moto
officine di moto
officine di riparazioni moto
officine di riparazioni per moto
riparazione di moto
discoteca
night-club
discoteche
night-club
locale notturno
night-club
locali notturni
night-club
casa di riposo
nursing-home
casa per anziani
nursing-home
case di riposo
nursing-home
case per anziani
nursing-home
articoli di cancelleria
cancelleria
autosili
parking-garage
331
► API Reference
Query Term
Category
autosilo
parking-garage
parcheggi
parking
parcheggi all'aperto
parking
parcheggio all'aperto
parking
posteggi
parking
posteggio
parking
area di servizio
petrol-station
carburante
petrol-station
distributore
petrol-station
distributore carburante
petrol-station
distributore di benzina
petrol-station
distributore di carburante
petrol-station
distributori
petrol-station
distributori benzina
petrol-station
distributori carburante
petrol-station
distributori di benzina
petrol-station
distributori di carburante
petrol-station
rifornimento
petrol-station
stazione rifornimento
petrol-station
stazioni rifornimento
petrol-station
negozi animali
pet-supply
negozio animali
pet-supply
medicina
pharmacy
fotografi
photography
fotografia
photography
fotografo
photography
questure
police-station
stazioni di polizia
police-station
uffici postale
post-office
aeroporto sportivo
332
► API Reference
Query Term
Category
agente immobiliare
realtor
agenti immobiliari
realtor
area di servizio
rest-area
area servizio
rest-area
area sosta
rest-area
aree di servizio
rest-area
aree servizio
rest-area
aree sosta
rest-area
luoghi di sosta
rest-area
luoghi sosta
rest-area
luogo di sosta
rest-area
luogo sosta
rest-area
piazzola di sosta
rest-area
piazzola sosta
rest-area
piazzole di sosta
rest-area
piazzole sosta
rest-area
trattoria
restaurant
trattorie
restaurant
poligono di tiro
shooting-range
bottega
shop
botteghe
shop
sciovia
ski-lift
sciovie
ski-lift
stazione sciistica
ski-resort
club di calcio
soccer-club
negozi di articoli sportivi
sporting-goods-store
negozio di articoli sportivi
sport
sport
supermercati
supermarket
supermercato
supermarket
333
► API Reference
Query Term
Category
confetteria
sweet-shop
confetterie
sweet-shop
negozi di dolciumi
sweet-shop
negozio di dolciumi
sweet-shop
sinagoga
synagogue
sinagoghe
synagogue
sarti
sarto
sartoria
sartorie
autopubblica
taxi
autopubbliche
taxi
posteggi di taxi
taxi-stand
posteggio di taxi
taxi-stand
commercialista
tax-service
cambio dei pneumatichi
tires
cambio della gomma
tires
cambio di gomma
tires
cambio di pneumatico
tires
pneumatichi
tires
pneumatico
tires
ente del turismo
tourist-information
ente per il turismo
tourist-information
ente turistico
tourist-information
enti del turismo
tourist-information
enti per il turismo
tourist-information
enti turistico
tourist-information
uffici del turismo
tourist-information
ufficio del turismo
tourist-information
rimorchio
towing-service
334
► API Reference
Query Term
Category
traduttore
traduttori
agenzia turistica
travel-agency
agenzie di viaggio
travel-agency
agenzie turistica
travel-agency
agenzie viaggi
travel-agency
metropolitana
underground-station
stazione metro
underground-station
stazioni metro
underground-station
mercatini dell'usato
mercatino dell'usato
veterinaria
veterinarian
videoteca
videoteche
bottiglieria
wine-and-liquor
bottiglierie
wine-and-liquor
enoteca
wine-and-liquor
enoteche
wine-and-liquor
fiaschetteria
wine-and-liquor
fiaschetterie
wine-and-liquor
negozi di vini
wine-and-liquor
negozio di vini
wine-and-liquor
casa vinicola
winery
case vinicole
winery
vigneti
winery
vigneto
winery
abbigliamento da donna
womens-apparel
abbigliamento per donna
womens-apparel
moda femminile
womens-apparel
negozi di abbigliamento da donna
womens-apparel
335
► API Reference
Query Term
Category
negozi di abbigliamento per donna
womens-apparel
negozi di moda femminile
womens-apparel
negozio di abbigliamento da donna
womens-apparel
negozio di abbigliamento per donna
womens-apparel
negozio di moda femminile
womens-apparel
porto turistico
yacht-basin
giardini zoologici
zoo
giardino zoologico
zoo
parchi zoologici
zoo
List of Supported Turkish Category-like Query Terms
Query Term
Category
reklam ajansi
reklam ajansı
reklam ajanslari
reklam ajansları
tema parklari
amusement-park
tema parkları
amusement-park
akvaryumlar
aquarium
sanat muezeleri
art-museum
sanat müzeleri
art-museum
atm/banka/doeviz buerosu
atm-bank-exchange
atm/banka/döviz bürosu
atm-bank-exchange
otomobil kuluepleri
automobile-club
otomobil kulüpleri
automobile-club
yeni araba
i#kinci el otomobil saticilari
yeni araba bayi
i#kinci el otomobil satıcıları
plajlar
beach
336
► API Reference
Query Term
Category
oda kahvalti
bed-and-breakfast
oda kahvaltı
bed-and-breakfast
oda ve kahvalti
bed-and-breakfast
oda ve kahvaltı
bed-and-breakfast
bira
beer
bisiklet magazalari
bisiklet mağazaları
bisiklet magazasi
bisiklet mağazası
bisiklet tamir
bisiklet tamir atoelyeleri
bisiklet tamir atölyeleri
bisiklet tamircisi
guemruek kontrol noktasi
border-crossing
gümrük kontrol noktası
border-crossing
otogar
bus-terminal
otogarlar
bus-terminal
araba
car
arabalar
car
araba bayisi
car-dealer
araba saticilari
car-dealer
araba satıcıları
car-dealer
araba saticisi
car-dealer
araba satıcısı
car-dealer
otomobil saticilari
car-dealer
otomobil satıcıları
car-dealer
otomobil saticisi
car-dealer
otomobil satıcısı
car-dealer
oto saticilari
car-dealer
oto satıcıları
car-dealer
337
► API Reference
Query Term
Category
oto saticisi
car-dealer
oto satıcısı
car-dealer
satici
car-dealer
satıcı
car-dealer
otomobil
car
otomobiler
car
araba parcalari
araba parçaları
oto kiralama
car-rental
otomobil kiralama
car-rental
kumarhaneler
casino
mezarliklar
cemetery
mezarlıklar
cemetery
cocuk muezeleri
childrens-museum
cocuk muezesi
childrens-museum
çocuk müzeleri
childrens-museum
çocuk müzesi
childrens-museum
kafe
coffee
banliyoe treni
banliyö treni
insaat sirketi
construction
inşaat şirketi
construction
insaat sirketleri
construction
inşaat şirketleri
construction
konsolosluk
consulate
konsolosluklar
consulate
tueketici elektronigi
tüketici elektroniği
dis hekimleri
dentist
diş hekimleri
dentist
338
► API Reference
Query Term
Category
dalis
diving-centre
dalış
diving-centre
dalis merkezi
diving-centre
dalış merkezi
diving-centre
dalis merkezleri
diving-centre
dalış merkezleri
diving-centre
kuru temizleme
dry-cleaning
kuru temizlemeci
dry-cleaning
kuru temizleyiciler
dry-cleaning
elcilik
embassy
elçilik
embassy
elcilikler
embassy
elçilikler
embassy
egzoz gazi
emission-testing
egzoz gazı
emission-testing
goesteri merkezi
gösteri merkezi
feribot
ferry
feribotlar
ferry
itfaiye oerguetue
fire-department
itfaiye örgütü
fire-department
spor salonlari
fitness-health-club
spor salonları
fitness-health-club
spor salonu
fitness-health-club
yiyecek
food
cenaze
funeral-director
mobilya
furniture-store
mobilya magazalari
furniture-store
mobilya mağazaları
furniture-store
mobilya magazasi
furniture-store
339
► API Reference
Query Term
Category
mobilya mağazası
furniture-store
sanat galerileri
gallery
sanat galerisi
gallery
bahce merkezi
garden-center
bahçe merkezi
garden-center
bahce merkezleri
garden-center
bahçe merkezleri
garden-center
perakendecilik
general-merchandise
golf kursu
golf-course
golf sahalari
golf-course
golf sahaları
golf-course
misafirhane
guest-house
tarih muezeleri
history-museum
tarih muezesi
history-museum
tarih müzeleri
history-museum
tarih müzesi
history-museum
buz hokeyi
hockey
nalbur duekkani
nalbur dükkânı
hosteller
hostel
pansiyonlar
hostel
buz pateni pisti
ice-skating
buz paten pistleri
ice-skating
caz
jazz-club
caz kulübü
jazz-club
caz kuluebue
jazz-club
caz kuluepleri
jazz-club
caz kulüpleri
jazz-club
caz muezigi
jazz-club
caz müziği
jazz-club
340
► API Reference
Query Term
Category
anaokulu
kindergarten
camasir
laundry
çamaşır
laundry
camasirhane
laundry
çamaşırhane
laundry
camasirhaneler
laundry
çamaşırhaneler
laundry
kuetuephaneler
library
kütüphaneler
library
cilingir
çilingir
kilit ustasi
kilit ustası
piyango
lottery-booth
avm
mall
pazar
market
pazarlar
market
cep telefonu
mobile-retailer
motorsiklet bayi
motorcycle-dealer
motorsiklet bayileri
motorcycle-dealer
motorsikletler
motorcycle-dealer
film
movie
filmler
movie
muezeler
museum
müzeler
museum
gece kulübü
night-club
gece kuluebue
night-club
gece kuluepleri
night-club
gece kulüpleri
night-club
huzurevi
nursing-home
341
► API Reference
Query Term
Category
huzurevleri
nursing-home
kirtasiye
kırtasiye
goezluekcue
optical
goezluekcueler
optical
gözlükçü
optical
gözlükçüler
optical
optisyen
optical
acik park yeri
parking
açık park yeri
parking
katli otopark
parking-garage
katlı otopark
parking-garage
otoparklar
parking-garage
otopark
parking
park alani
parking
park alanı
parking
park yerleri
parking
pet magazalari
pet-supply
pet mağazaları
pet-supply
pet magazasi
pet-supply
pet mağazası
pet-supply
fotografci
photography
fotoğrafçı
photography
fotografcilar
photography
fotoğrafçılar
photography
fotografcilik
photography
fotoğrafçılık
photography
fotoğraf stüdyoları
photography
fotoğraf stüdyosu
photography
fotograf stuedyolari
photography
342
► API Reference
Query Term
Category
fotograf stuedyosu
photography
polis karakollar
police-station
polis merkezi
police-station
polis merkezleri
police-station
gar
railway-station
gayrimenkul
emlakci
realtor
emlâkçı
realtor
emlakcilar
realtor
emlakçılar
realtor
film magaza
record-cd-and-video
film mağaza
record-cd-and-video
film magazalari
record-cd-and-video
film mağazaları
record-cd-and-video
okul
school
okullar
school
bilim muezeleri
science-museum
bilim muezesi
science-museum
bilim müzeleri
science-museum
bilim müzesi
science-museum
ayakkabi
shoes-footwear
ayakkabı
shoes-footwear
ayakkabi magazalari
shoes-footwear
ayakkabı mağazaları
shoes-footwear
ayakkabi magazasi
shoes-footwear
ayakkabı mağazası
shoes-footwear
poligon
shooting-range
teleski
ski-lift
futbol
soccer-club
futbol kulübü
soccer-club
343
► API Reference
Query Term
Category
futbol kuluebue
soccer-club
futbol kuluepleri
soccer-club
futbol kulüpleri
soccer-club
spor ekipmani
spor ekipmanı
spor magazalari
spor mağazaları
spor magazasi
spor mağazası
spor alani
sports-field
spor alanı
sports-field
spor zemin
sports-field
spor
sport
stadyumlar
stadium
suepermarket
supermarket
suepermarketler
supermarket
süpermarket
supermarket
süpermarketler
supermarket
havuz
swimming-pool
yuezme havuzlar
swimming-pool
yüzme havuzlar
swimming-pool
havra
synagogue
havralar
synagogue
sinagog
synagogue
sinagoglar
synagogue
terzi
terziler
taksi duraglari
taxi-stand
taksi durağları
taxi-stand
taksiler
taxi
344
► API Reference
Query Term
Category
tenis kortlari
tennis-court
tenis kortları
tennis-court
tiyatrolar
theatre
otomobil lastikleri
tires
tuvalet
toilet
tuvaletler
toilet
turistik
tourist-attraction
turistik bilgiler
tourist-information
cevirmen
çevirmen
cevirmenler
çevirmenler
kamyon tamir
truck-repair
metro istasyonu
underground-station
veterinerler
veterinarian
video kuetuephanesi
video kütüphanesi
atari salonu
kadin giysileri
womens-apparel
kadın giysileri
womens-apparel
kadin moda
womens-apparel
kadın moda
womens-apparel
List of Supported Chain-like Query Terms
Chain Name
Query Term
Best Western
best western hotel
BP
•
bp petrol station
•
stacja benzynowa bp
Hess Express
hess express
Lakeshore Learning
lakeshore learning
345
► API Reference
Chain Name
Query Term
Mobil
mobil gas station
TOTAL
station service total
MORRISONS
morisons
Sheraton
•
sheraton
•
sheraton hotel
TAMOIL
tamoil
REPSOL
gasolinera repsol
Bancolombia
cajero bancolombia
Radisson Edwardian Hotels
•
radisson edwa
•
radisson edwardian hotels
Chevron
chevron gas
Davivienda
cajero davivienda
ARCO
arco
Cenex
cenex
Exxon
exxon gas station
COURTYARD by Marriott
courtyard mariott
Drury Inn
drury inn & suites
Fairfield Inn by Marriott
fairfield inn by marriott
Homewood Suites
homewood suites
Omni Hotels
omni hotels
Red Carpet Inn
red carpet inn
Sleep Inn
sleep inn
Sleep Inn
sleep inn & suites
LEXUS
lexus
TOYOTA
toyota
Mercedes-Benz
•
mercedes
•
mercedes-benz
RENAULT
renault
OPEL
opel
Volkswagen
volkswagen
346
► API Reference
Chain Name
Query Term
PEUGEOT
peugeot
Lincoln
lincoln
Ford
ford
ALFA ROMEO
alfa romeo
ASTON MARTIN
aston martin
Audi
audi
BENTLEY
bentley
Bugatti
bugatti
BUICK
buick
Cadillac
cadillac
CHEVROLET
chevrolet
CHRYSLER
chrysler
CITROËN
citroen
DAIHATSU
daihatsu
DODGE
dodge
Ferrari
ferrari
FIAT
fiat
GM
gm
GMC
gmc
HYUNDAI
hyundai
INFINITI
infiniti
ISUZU
isuzu
Jeep
jeep
KIA
kia
LAMBORGHINI
lamborghini
LANCIA
lancia
MASERATI
maserati
MITSUBISHI
mitsubishi
MORGAN
morgan
NISSAN
nissan
347
► API Reference
Chain Name
Query Term
PORSCHE
porsche
SAAB
saab
SEAT
seat
SKODA
skoda
SsangYong
ssangyong
SUBARU
subaru
SUZUKI
suzuki
TRIUMPH
triumph
VAUXHALL
vauxhall
VOLVO
volvo
Microtel Inns & Suites
microtel inns & suites
Budget
•
budget car rental
•
budget rental
Holiday Stationstores
holiday gas station
Kum & Go
kum & go
Love's Country Store
love's country store
Speedway
speedway gas
Speedway
speedway gas station
United Dairy Farmers
united dairy farmers
Thrifty
thrifty
MACDONALD
•
macdonald
•
macdonald hotel
Uno-X
uno-x
CUMULUS
cumulus
CUMULUS
hotelli cumulus
Valero
valero gas station
Pap Oil
papoil
Slovnaft
slovnaft
FOUR POINTS BY SHERATON
•
four points by sheraton
•
sheraton-four points
348
► API Reference
Chain Name
Query Term
MAYBACH
maybach
HUMMER
hummer
ORLEN
•
orlen
•
stacja orlen
Eurooil
eurooil
smart
smart
Budgens
budgens
Marks & Spencer
marks and spenser
HSBC
cajero hsbc
halfords autocentre
halfords autocentre
Hi-Q
hi-q
National Tyres & Autocare
national tyres & autocare
SEB
seb
LIDL
liddl
Holden
holden
PROTON
proton
Midas
midas auto service & tires
Associated Bank
associated bank
BancFirst
bancfirst
BancorpSouth
bancorpsouth
Bank of America
•
b of a
•
bank of america
•
bank america
•
bank if america
•
bank of america cash machine
Bank of Hawaii
bank of hawaii
BMO Bank of Montreal
bmo bank of montreal
Banque Scotia
banque scotia
Chase
chace bank
Comerica
comerica
First Federal
first federal
349
► API Reference
Chain Name
Query Term
Hancock Bank
hancock bank
Harris Bank
harris bank
The Huntington National Bank
hunington bank
M&T Bank
m and t bank
MidFirst Bank
midfirst bank
Northern Trust
northern trust
PNC Bank
pnc atm
Regions
region bank
RBC Royal Bank
rbc banque royale
Scotiabank
banco scotiabank
Gloria Jean's
gloria jean's
Peet's Coffee & Tea
peets coffee
Starbucks
•
closest starbucks
•
srarbucks
•
starbucka
•
starbuks
•
startbucks
•
statbucks
•
sturbucks
Tim Hortons
tim horton
Kings Super Markets
kings super markets
Nob Hill Foods
nob hill foods
Save-A-Lot
sav a lot
Trader Joe's
traders joe
Trader Joe's
traider joes
Whole Foods
whole fooda
Whole Foods
whole foods markets
Duane Reade
duane reade
Duane Reade
dwayne reed
Meijer Pharmacy
meijer pharmacy
Publix
publix grocery store
350
► API Reference
Chain Name
Query Term
Rite Aid
•
rite aid pharmacy
•
rite aide
Stop & Shop
stop n shop
Walgreens
•
walgreens
•
walgreena
•
walgteens
•
walgreens pharmacy
AVIS
avis car rental
Dollar Rent A Car
•
dollar car rental
•
dollar rent a car
•
ben & jerry's
•
ben and jerry
•
ben and jerrys
•
bobs big boy
•
bobs big boys
Ben & Jerry's
Big Boy
Bonefish Grill
bonefish
Buffalo Wild Wings
•
bufalo wild wings
•
bufflo wild wings
•
burger king
•
berger king
BURGER KING
Carl's Jr
carl jr
Carrabba's Italian Grill
•
carabbas
•
carrabbas
Champps
champps
Chick-fil-A
•
chic filet
•
chick filet
•
chick fill a
•
chik filet
Chili's Grill & Bar
chiles
Chipotle
•
chipoltle
•
chipotles
351
► API Reference
Chain Name
Query Term
•
chiptole
Chuck E Cheese's
chuckee cheese
Church's Chicken
church chicken
Dairy Queen
diary queen
Del Taco
•
del taco
•
del taci
•
dell taco
•
denneys
•
dennys restaurant
Denny's
Dunkin' Donuts
donkin donuts
Fosters Freeze
fosters freeze
Godfather's
godfather's
Hard Rock CAFE
•
hard rock cafe
•
hard rok caffe
•
joe crab shack
•
joes crab
Joe's Crab Shack
KFC
kentucky fried chicken
Little Caesars
•
little caesers
•
little ceaser
•
little ceaser pizza
•
little cesar pizza
•
little cesars pizza
Lone Star Steakhouse
lone star steakhouse
Max & Erma's
max & erma's
McDonald's
•
mac do
•
mccdonalds
•
mcdinalds
•
mcdobalds
•
mcdonalda
•
mcdonaldd
•
mcdonalfs
•
mcdonlds
352
► API Reference
Chain Name
Panera Bread
Papa John's
Query Term
•
mcdonnalds
•
mec donalds
•
mecdonald
•
panara
•
panara bread
•
papa john
•
pizza papa johns
Papa Romano's
papa romano's
Perkins
perkins restaurant
Pizza Hut
•
pizza hut
•
pizza hit
•
pizza hutt
•
puzza hut
•
popeyes
•
popeys
•
popyes
Popeyes
Rally's
rally's hamburgers
Red Robin
•
red robin
•
red robbin
•
red robin gourmet burgers & spirits
•
red robin restaurant
•
red robins
Romano's Macaroni Grill
macroni grill
sbarro
sbarro
Steak n Shake
steak & shake
Black Angus Steakhouse
black angus
SUBWAY
sabway
TGI Friday's
•
t.g.l friday's
•
tgi friday's
Wendy's
wendeys
Whataburger
wataburger
353
► API Reference
Chain Name
Query Term
Wienerschnitzel
weinerschnitzel
Applebee's
applebee
Arby's
arby
Baja Fresh
baja fresh mexican grill
Cottage Inn Pizza
cottage inn pizza
Cracker Barrel Old Country Store
•
crackel barrel
•
cracker barrell
•
crackle barrel
IHOP
ihope
IHOP
international house of pancakes
Jack in the Box
•
jack and the box
•
jack in box
•
jimmie johns
•
jimmy john
Jimmy John's
Round Table Pizza
round table
AAMCO Transmissions
aamco
ABRA Autobody & Glass
abra autobody & glass
Christian Brothers Automotive
christian brothers automotive
Express Oil Change
express oil change
Jiffy Lube
jiffy
Monro Muffler Brake & Service
monro muffler brake & service
Pep Boys
•
pep boys auto parts & service
•
pepboy
Valvoline Instant Oil Change
valvoline
Banca Popolare di Bergamo
banca popolare di bergamo
Banca Popolare di Novara
banca popolare di novara
Banca Popolare di Vicenza
banca popolare di vicenza
BPM BANCA POPOLARE DI MILANO
bpm banca popolare di milano
Banco di Brescia
banco di brescia
BBVA
cajero bbva
354
► API Reference
Chain Name
Query Term
UniCredit Banca
banca unicredit
Baymont Inn & Suites
•
baymont inn & suites
•
baymont inn and suites
Acme Markets
acme markets
Bruegger's
bruegger's
Carvel
carvel ice cream
Cheesecake Factory
cheescake factory
Cici's Pizza
•
cici's pizza
•
cicis pizzas
Dave & Busters
david and buster
Daylight Donuts
daylight donuts
Golden Corral
golden carrol
Krispy Kreme
krispy kream donuts
On the Border
•
on the boarder
•
on the border mexican cafe
Ralphs
ralphs grocery store
Ruth's Chris Steak House
ruths chris
SASOL
•
sasol
•
sasol garage
Al Tazaj
al tazaj
Debonairs Pizza
debonairs
Syndicate Bank
syndicate bank atm
Uco Bank
uco bank atm
Union Bank of India
union bank of india atm
Banca Popolare Dell'Emilia Romagna
banca popolare dell'emilia romagna
Banca Popolare di Sondrio
banca popolare di sondrio
GE Money Bank
ge money bank
Santander
•
santander
•
santander banks
Sparda Bank
sparda bank
355
► API Reference
Chain Name
Query Term
Alnatura
alnatura
marché franprix
marché franprix
Andhra Bank
andhra bank atm
ANZ
•
anz atm
•
anz bank
•
atm (anz)
Bank of Baroda
bank of baroda atm
Corporation Bank
corporation bank atm
Hdfc Bank
hdfc bank atm
Ing Vysya
ing vysya
Oriental Bank of Commerce
obc bank
State Bank of India
state bank of india atm
Hilton Garden Inn
hilton garden
Staybridge Suites
•
staybridge
•
staybridge suites
Maggiano's
magianos
T-Mobile
t mobil
AMC Theatres
•
amc loews
•
amc theatres
•
hom depot
•
home depit
•
hone depot
Home Depot
Éléphant Bleu
éléphant bleu
Best Buy
•
beat buy
•
best buy store
•
dicks sport
•
dicks sporting good
•
ross department store
•
ross dress
•
targer
Dick's Sporting Goods
Ross Dress For Less
Target
356
► API Reference
Chain Name
Kohl's
Query Term
•
targey
•
kohl
•
kolhs
Lowe's
lowes hardware
Walmart
•
wakmart
•
walkmart
•
walmaet
•
walmark
•
walmarts
•
walmatt
•
wamart
•
wolmart
Auntie Anne's
auntie anne's
City Gross
city gross
Coop Forum
coop forum
Coop Konsum
coop konsum
Kvickly
kvickly
Selver
selver
Superbest
superbest
Superbrugsen
superbrugsen
Superquinn
superquinn
valintatalo
valintatalo
Park Inn
•
park inn
•
park inn hotel
•
absa atm
•
absa bank
ABSA
African Bank
african bank
ALPHA BANK
alpha bank
Banc Post
banc post
Banco do Brasil
banco brasil
Bank Austria
bank austria
357
► API Reference
Chain Name
Query Term
Bank of Cyprus
bank of cyprus
Bank BPH
bank bph
getin bank
getin bank
Hamburger Sparkasse
hamburger sparkasse
Handelsbanken
handelsbanken
Millennium Bank
millennium bank
Nedbank
nedbank atm
PKO Bank Polski
bank pko
Postfinance
postfinance
Supa Quick
supa quick
DACIA
dacia
Odeon
•
cinema odeon
•
odeon
•
showcase
•
showcase cinema
Showcase
Village Cinemas
village cinemas
Carino's Italian Grill
carino's italian grill
Don Pablo's Mexican Kitchen
•
don pablo's
•
don pablo's mexican kitchen
•
tamilnad mercantile bank
•
tamilnadu mercantile bank
Tamilnad Mercantile Bank
Mahindra
mahindra
MARUTI SUZUKI
maruti suzuki
TATA
tata
Boulanger
boulanger
La Plateforme du Bâtiment
la plateforme du bâtiment
Bricomarché
bricomarché
Toys"R"Us
toys are us
Zaxby's
zaxby
bd's Mongolian Grill
bd's mongolian barbeque
358
► API Reference
Chain Name
Query Term
California Tortilla
california tortilla
Crispers
crispers
Famous Dave's
famous dave's bar-b-que
Ivar's
ivars salmon house
Jack Astor's
jack astor's
Jason's Deli
jason deli
LePeep Restaurant
lepeep restaurant
Mazzio's
mazzio's
Olga's Kitchen
olga's kitchen
Pepe's Mexican Restaurant
pepe's mexican restaurant
Port of Subs
port of subs
Potbelly Sandwich Shop
potbelly sandwich shop
Rafferty's
rafferty's
Robeks
robeks
Rock Bottom
rock bottom brewery restaurant
Saladworks
saladworks
Thundercloud Subs
thundercloud subs
Wetzel's Pretzels
wetzel's pretzels
Yard House
•
yard house
•
yardhouse bar & grill
Aladdin's Eatery
aladdin's eatery
Nordstrom
nordstorm
Pier 1 Imports
pier one imports
Office Depot
ofice depot
Bank Central Asia
bank central asia
Bank Danamon
bank danamon
Bank Indonesia
bank indonesia
CIMB Niaga
cimb niaga
Permata Bank
permata bank
Perodua
perodua
359
► API Reference
Chain Name
Query Term
Bhpetrol
bhpetrol
IKEA
ικεα
Costco
costci
Marshalls
marshalls department store
Euronet
bankomat euronet
Interdiscount
interdiscount
ELKJØP
elkjøp
Towneplace Suites
•
towneplace suites
•
townplace suites
Panchero's Mexican Grill
panchero's mexican grill
Nickelodeon Family Suites
nickelodeon family suites
CORVETTE
corvette
Pum Plastiques
pum plastiques
Cheeburger Cheeburger
cheeburger cheeburger
Claim Jumper
•
claim jumper restaurant
•
claim jumpers
Red Hot & Blue
red hot & blue
Juan Pollo
juan pollo
Napa Auto Parts
napa auto
Kal Tire
kal tire
O'Reilly Auto Parts
•
o'rilley's auto parts
•
oreily auto parts
•
oriellys auto parts
Happy Center
happy center
H&R Block
hnr block
Sultanahmet Köftecisi
sultanahmet köftecisi
Terpel
terpel
Macro
•
banco macro
•
macro
Banco de Chile
banco de chile
360
► API Reference
Chain Name
Query Term
BCI
bci
Zaffari
zaffari
Marble Slab Creamery
marble slab
Banco Mercantil
banco mercantil
Winchell's
winchell's
BIPA
bipa
Casual Male
casual male
Coldwater Creek
coldwater creek
Motherhood Maternity
motherhood maternity
New York & Company
•
new york & company
•
new york and company
Shoe Dept
shoe dept
Stride Rite
stride rite
Torrid
torrid
Wet Seal
wet seal
White House-Black Market
white house-black market
BLOKKER
blokker
Crown Fried Chicken
crown fried chicken
Catherines
catherines
OshKosh B'gosh
oshkosh b'gosh
Timberland
•
timberland
•
timberland store
KONZUM
konzum
Diamond Bank
diamond bank
Guaranty Trust Bank
guaranty trust bank
Caixa Geral de Depósitos
caixa geral de depósitos
Minipreço
minipreço
Caisse Populaire Desjardins
caisse populaire desjardins
Food Basics
food basics
Milestone's
milestone's
361
► API Reference
Chain Name
Query Term
White Spot
white spot
Jean Coutu
jean coutu
Home Hardware
home hardware
Berliner Volksbank
berliner volksbank
Hamburger Volksbank
hamburger volksbank
Sparkasse KölnBonn
sparkasse kölnbonn
THE BISHOPS ARMS
the bishops arms
Peek & Cloppenburg
peek & cloppenburg
citi handlowy
citi handlowy
mBank
mbank
Santander CONSUMER BANK
santander consumer bank
Kruidvat
kruidvat
Barnes & Noble Booksellers
barns and nobles
Unicredit Tiriac Bank
unicredit țiriac bank
Cec Bank
cec bank
Sushi Itto
sushi itto
Benedetti's
benedetti's
Potzollcalli
potzollcalli
Italianni's
italianni's
El Pollo Pepe
el pollo pepe
Afirme
afirme
Banamex
•
banco banamex
•
cajero banamex
BANBAJIO
banbajio
Banorte
cajero banorte
Bbva Bancomer
cajero bancomer
Farmacias Benavides
farmacia benavides
Curves
curves
promod
promod
McCafé
mccafé
362
► API Reference
Chain Name
Query Term
Block House
block house steakrestaurant
DRESSMANN
dressmann
FONA
fona
jem & fix
jem & fix
marimekko
marimekko
Vinmonopolet
vinmonopolet
Droga Raia
droga raia
Erfurter Bank
erfurter bank
Bhs
bhs
Dorothy Perkins
dorothy perkins
Fat Face
fat face
London Camera Exchange
london camera exchange
Miss Selfridge
miss selfridge
Primark
•
primark
•
primark stores ltd
Richer Sounds
richer sounds
Sportsdirect.Com
sportsdirect.com
FirstMerit Bank
firstmerit bank
Flagstar Bank
flagstar bank
Sterling Savings Bank
sterling savings bank
Trustmark National Bank
trustmark national bank
Umpqua Bank
umpqua bank
Washington Federal Savings
washington federal savings
Webster Bank
webster bank
Whitney Bank
whitney bank
St Louis Bread Co
st louis bread co
SUOMALAINEN KIRJAKAUPPA
suomalainen kirjakauppa
Great Wall Motor
great wall motor
Dollar Bank
dollar bank
First Hawaiian Bank
first hawaiian bank
363
► API Reference
Chain Name
Query Term
Fulton Bank
fulton bank
Nevada State Bank
nevada state bank
Banco Ahorro Famsa
banco ahorro famsa
Fiesta Americana
fiesta americana
SPC
spc
Incredible Connection
incredible connection
Cashbuild
cashbuild
Mr Price Home
mr price home
Waltons
waltons
Stein Mart
stain mart
Ledo Pizza and Pasta
•
ledo pizza
•
ledo pizza and pasta
Oil Can Henry's
oil can henry's
BED BATH & BEYOND
bed bath
Giant Pharmacy
giant pharmacy
Glasfit
glasfit
sasol delight!
sasol delight!
MATRIX WAREHOUSE COMPUTERS
matrix warehouse computers
Virgin mobile
virgin mobile
GOLDWAGEN
goldwagen
Quick Chek
quick chek
Spur Steak Ranches
spur steak ranches
POSB
posb
UOB
uob bank
OCBC
•
ocbc
•
ocbc branch
Fairprice
fairprice
TMB BANK
•
tmb
•
tmb bank
YA KUN KAYA TOAST
ya kun kaya toast
364
► API Reference
Chain Name
Query Term
Rocky Mountain Chocolate Factory
rocky mountain chocolate factory
Red Wing Shoes
red wing shoe
David's Bridal
david bridal
Dunham's Sports
dunham's sports
Harbor Freight Tools
harbor frieght
Burlington Coat Factory
•
berlington coat factory
•
burlington coat
•
dolar tree
•
doller tree
•
dollor trees
Dollar Tree
Big O Tires
big o
Hoyts
•
hoyts
•
hoyts cinemas
Priceline
priceline
MIKE'S KITCHEN
mike's kitchen
Scooters Pizza
scooters pizza
Hugendubel
hugendubel
CineStar
cinestar
Abu Dhabi Islamic Bank
abu dhabi islamic bank
Commercial Bank of Dubai
commercial bank of dubai
DOHA BANK
doha bank
Habib Bank AG Zurich
habib bank ag zurich
NATIONAL BANK OF FUJAIRAH
national bank of fujairah
Sharjah Islamic bank
sharjah islamic bank
United Arab Bank
united arab bank
Jordan Islamic Bank
jordan islamic bank
SHOE CITY
shoe city
Vila Galé
•
hotel vila gale
•
vila galé
Merchant's Tire & Auto
merchant's tire & auto
365
► API Reference
Chain Name
Query Term
Fenerium
fenerium
Koton
koton
Profilo
profilo
Komagene
komagene
Eat'n Park
eat'n park
Brookshire's
brookshire's
Hannaford
•
hannaford
•
hannaford supermarket
Lowes Foods
lowes foods
Intratuin
intratuin
Alliance Bank
alliance bank
99 Speed Mart
99 speedmart
Sweetbay Supermarket
sweetbay supermarket
Great Harvest Bread Co.
•
great harvest bread
•
great harvest bread co.
•
ajman city centre llc
•
ajman city centre mall
Ajman City Centre LLC
MAXIMA XX
maxima xx
MAXIMA XXX
maxima xxx
Mall of the Emirates LLC
mall of the emirates llc
Equity Bank
equity bank
Shoprite U Save
shoprite u save
Michaels
michaels craft
PAPPADEAUX SEAFOOD KITCHEN
papadeaux seafood kitchen
TOPS Friendly Markets
tops friendly markets
Sweet Tomatoes
sweet tomato
Halyk Bank
halyk bank
Bose Retail Store
bose retail store
The EGG & I
the egg & i
Kroger Fuel Center
kroger fuel center
366
► API Reference
Chain Name
Query Term
King Soopers Fuel Center
king soopers fuel center
Foods Co
•
food co
•
foods co
Loaf 'N Jug
loaf 'n jug
Fred Meyer Fuel Center
fred meyer fuel center
Interbank
interbank
Hoka Hoka Bento
hoka hoka bento
DAVID JONES
david jones
REBEL SPORT
rebel sport
Officeworks
office work
Ryman the Stationer
ryman the stationer
JUMBO Specialty Store
jumbo specialty store
REMAX
remax
Century 21
•
21 century
•
century 21
DNB
dnb
Radisson Blu Hotels & Resorts
•
blu radison
•
radisson blu hotels & resorts
PTT Bank
ptt bank
Pague Menos
pague menos
TESCO Lotus express
tesco lotus express
AutoBarn
autobarn
eni
eni
Battery Centre
battery centre
Fruit & Veg City
fruit & veg city
Telenor
telenor
INDISKA
indiska
Grand Frais
grand frais
budget sport
budget sport
Optus
optus
367
► API Reference
Chain Name
Query Term
Ethan Allen
ethan allen
Rainbowshops
rainbowshops
Shane's Rib Shack
shane's rib shack
VAPIANO
vai piano
Midpoint
midpoint
Big Chefs
big chefs
Continente Modelo
continente modelo
Charlie Brown's Steakhouse
charlie brown's steakhouse
MEC
mec
MEC
mountain equipment co-op
Scion
scion
Banco de Córdoba
banco de córdoba
Super Vea
super vea
Sarpino's Pizzeria
sarpino's pizzeria
Salsarita's Fresh Cantina
salsarita's fresh cantina
United Community Bank
united community bank
Modell's Sporting Goods
modells
Big Y
big y
ACO Hardware
aco hardware
Slumberland Furniture
slumberland furniture
Slice of Italy
slice of italy
Dehner
dehner
Thomas Philipps
thomas philipps
Enjaz Banking Services
enjaz banking services
Patchi
patchi
Shawaya House
shawaya house
Boxer Superstores
boxer superstores
Medicross Medical Centre
medicross medical centre
Halpa-Halli
halpa-halli
RAUTIA
rautia
368
► API Reference
Chain Name
Query Term
Force
force
Hindustan Motors
hindustan motors
Booker Cash & Carry
booker cash & carry
Bank Jatim
bank jatim
Bimeks
bimeks
Frango Assado
frango assado
Sicredi
sicredi
netonnet
netonnet
CUPPA
cuppa
JOHN PLAYERS
john players
ALLEN SOLLY
allen solly
Bunnings
•
bunnings
•
bunnings warehouse
SURTIMAX
surtimax
bansefi
bansefi
CAJA POPULAR MEXICANA
caja popular mexicana
Fabricas de Francia
fabricas de francia
The Italian Coffee Company
the italian coffee company
MultiPack
multipack
Academy Sports+Outdoors
•
academy sports and outdoors
•
academy sports+outdoors
ARTURO CALLE
arturo calle
Frisby
frisby
SUPERSPAR
superspar
Sneaky Pete's
sneaky pete's
Straw Hat Pizza
straw hat pizza
Streets of New York
streets of new york
Livraria Cultura
livraria cultura
Ricardo Eletro
ricardo eletro
Garbarino
garbarino
369
► API Reference
Chain Name
Query Term
Farmacias San Pablo
farmacias san pablo
Sports Toto
sports toto
Mercadorama
mercadorama
Nasi Kandar Pelita
nasi kandar pelita
NISSAN LEAF
nissan leaf
Teachers Credit Union
teachers credit union
American Family Insurance
american family insurance
Farmers Insurance
farmers insurance
Jackson Hewitt Tax Service
jackson hewitt tax service
La Petite Academy
la petite academy
Nationwide Insurance
nationwide insurance
Ryder Truck Rental and Leasing
ryder truck rental and leasing
Sylvan Learning Center
sylvan learning center
Terminix
terminix
Apria Healthcare
apria healthcare
Adecco Employment Services
adecco employment services
Bally Total Fitness
bally total fitness
EZPAWN
ez pawn e
Fraternal Order of Eagles
fraternal order of eagles
Georgia-Pacific
georgia-pacific
Pro-Cuts
pro-cuts
Tractor Supply Co
tractor supply co
Walmart Supercenter
•
ealmart
•
wlamart
Blue Cross & Blue Shield
blue cross & blue shield
Marine Corps Recruiting
marine corps recruiting
Army National Guard
army national guard
WIC State Agency
wic state agency
World Gym Fitness Center
world gym fitness center
Helzberg Diamonds
helzberg diamonds
370
► API Reference
Chain Name
Query Term
Calvary Chapel
calvary chapel
Hallmark Gold Crown
hallmark gold crown
Liberty Tax Service
liberty tax
Smartstyle Family Hair Salon
smartstyle family hair salon
Waste Management
•
waste management
•
waste management transfer station
DaVita Dialysis Center
davita dialysis center
Dish Network
dish network
Labor Finders
labor finders
Color Me Mine
color me mine
Aerotek
•
aerotek
•
aerotek staffing agency
Discount Drug Mart
discount drug mart
Keller Williams Realty
keller williams realty
Signs By Tomorrow
signs by tomorrow
Extreme Pizza
extreme pizza
Filippi's Pizza Grotto
filippi's pizza grotto
The Little Gym
the little gym
Plato's Closet
platoes closet
Design Within Reach
design within reach
Rockler Woodworking and Hardware
rockler woodworking and hardware
Sierra Trading Post
sierra trading post
Biscuitville
biscuitville
Lincoln Technical Institute
lincoln technical institute
Eyemart Express
eyemart express
Phoenix Children's Hospital
phoenix children's hospital
Eyeglass World
eyeglass world
Charles Schwab
•
charles schwab
•
charles schwab corp
Bright Horizons
bright horizons
371
► API Reference
Chain Name
Query Term
CheckSmart
checksmart
Destination Maternity
destination maternity
Festival Foods
festival foods
► Places (Search) API Coverage
372
Appendix
A
Places (Search) API Coverage
When you use the Places (Search) API to build an application, your
users can find individual locations in
•
•
•
over 200 countries
over 1.5 million different areas (cities, districts, regions)
over 25 million streets split into 90 million and more individual
segments
In an increasing number of countries, the Places (Search) API
provides detailed, building-specific location data – currently over
200 million point addresses.
Places (Search) API offers information about millions of named and
categorised places in more than 200 countries:
•
•
over 40 countries with more than 100,000 places
over 80 countries with between 1,000 and 100,000 places
Several million of those places come with rich attribution/content
like:
•
•
•
editorial information for trusted content partners
ratings, reviews and images aggregated from a variety of
online communities
additional business information, often provided by the owner

Places (Search) API - Places API

Transcription

Similar documents

Whitepages Pro Caller Identification API

Quarterly NL May 2010-b

ni.com - SDL.com

Together Middlesbrough March 2015 Newsletter

The Way to San Jose - Things to Do

Siegfried`s One Stop Shop for partners in the pharmaceutical industry

Connichiwa – A Framework for Cross

NewsFlash AED group 09_2014

November 2013 - API

Batch Production of Driving Distances and Times Using SAS® and