Find a Place using a Text String
To find a specific place, such as one with the word pilates in the name, send the following GET request.
https://opensearch.hereapi.cn/places/v1/discover/search
?at=40.71455%2C-74.00714
&q=pilates
&maxresults=20
&lang=en-US
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE} The response to the above request includes the following high level elements:
- a
resultsarray containing items that represent suggested places - metadata – information on each place such as the title, position, category, bounding box, and so on
Most web browsers provide a collapsed array containing the response:
{
"results": [
{ "BK Pilates" },
{ "21 Pilates" },
{ "100s Pilates" },
{ "Pilates Room, NYC" },
{ "Pilates by Sylvia" },
{ "Karate Pilates" },
{ "Pilates on Fifth" },
{ "Beyond Pilates" },
{ "Shred Pilates" },
{ "Sola Pilates" },
{ "Power Pilates" },
{ "Imx Pilates Studio" },
{ "Center Pilates" },
{ "Pilates" },
{ "Big Apple Pilates" },
{ "CBK Pilates Flatiron" },
{ "Built Pilates" },
{ "Co Pilates" },
{ "Pilates Reforming New York" },
{ "Pilates on the Square" }
]
}
When expanded, each item in the array displays additional information about that place.
{
position: [
40.6103,
-73.94395
],
distance: 7720,
title: "BK Pilates",
averageRating: 0,
category: {
id: "sports-facility-venue",
title: "Sport Facility/Venue",
href: "https://...",
type: "urn:nlp-types:category",
system: "places",
icon: "https://download.vcdn.data.here.com/p/d/places2/icons/categories/30.icon"
},
icon: "https://download.vcdn.data.here.com/p/d/places2/icons/categories/30.icon",
vicinity: "
Nostrand Ave,
New York, New York 11229,
United States",
"having": [],
type: "urn:nlp-types:place",
href: "https://.../:cm:place:8403fv6k-6669348969e80d8d9b5b380af7f8e67f",
id: "here:cm:place:8403fv6k-6669348969e80d8d9b5b380af7f8e67f"
}