Places (Search) API China - BETA Developer's Guide

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