×

Discussion Board

Results 1 to 4 of 4
  1. #1
    Registered User
    Join Date
    Mar 2013
    Posts
    5

    Search response parameter definition

    I would like to have more clarification on places search response. See the response to my query below for starbucks in nyc gps:

    1) what are the options for having []? I see this appears in the response.
    2) how accurate is the vacinity address? is it just an approximation? Or is the definitely the address of the starbucks?
    3) what is the unit used by distance?

    Lastly as I have asked before, what documentation would provide answers to these precise types of questions?


    http://demo.places.nlp.nokia.com/pla...17%2C-73.98529 items: [ { Starbucks } { position: [ 40.74864 , -73.98841 ] distance: 270 title: Starbucks averageRating: 0.0 category: { Coffee/Tea } icon: http://download.vcdn.nokia.com/p/d/p...gories/23.icon vicinity: 906 6th Ave ↵
    New York City NY 10001 ↵
    USA having: [ ] type: urn:nlp-typeslace href:

  2. #2
    Nokia Developer Expert
    Join Date
    Mar 2003
    Location
    Lempäälä/Finland
    Posts
    29,143

    Re: Search response parameter definition

    I would suppose [] is empty list, anyway, you could always specify which parameter it is that you get it for.


    The docs are at: http://developer.here.com/places#_48...Findex.html%3F as said before as well. And please do not make dublicate entries for same questions.

  3. #3
    Nokia Developer Moderator
    Join Date
    May 2007
    Location
    21.46 N 72.11 E
    Posts
    3,777

    Re: Search response parameter definition

    Quote Originally Posted by fromplacetoplace View Post

    1) what are the options for having []? I see this appears in the response.

    http://demo.places.nlp.nokia.com/pla...17%2C-73.98529 items: [ { Starbucks } { position: [ 40.74864 , -73.98841 ] distance: 270 title: Starbucks averageRating: 0.0 category: { Coffee/Tea } icon: http://download.vcdn.nokia.com/p/d/p...gories/23.icon vicinity: 906 6th Ave ↵
    New York City NY 10001 ↵
    USA having: [ ] type: urn:nlp-typeslace href:
    having parameter is new, it wasn't there last I checked. It returns an empty list for all the POIs that I checked. It is undocumented and hence you may ignore it for now.
    Quote Originally Posted by fromplacetoplace View Post
    2) how accurate is the vacinity address? is it just an approximation? Or is the definitely the address of the starbucks?
    It should be pretty accurate, the data is very likely collected manually in most cases.
    Quote Originally Posted by fromplacetoplace View Post
    3) what is the unit used by distance?
    distance is in meters.
    Quote Originally Posted by fromplacetoplace View Post
    Lastly as I have asked before, what documentation would provide answers to these precise types of questions?
    Here's the documentation for the HERE places API: http://developer.here.com/places
    Pankaj Nathani
    www.croozeus.com

  4. #4
    Nokia Developer Expert
    Join Date
    Apr 2012
    Location
    Berlin, Germany
    Posts
    42

    Re: Search response parameter definition

    Hi,

    1) We will return some fields that are not documented. Generally, this means, they are experimental and you should not rely on them being always available.

    2) Vicinity is NOT necessarily an adress. Please don’t rely on it for exact addresses. The purpose of vicinity is a textual description of the search item to distinguish it from other items in the list (i.e., in the future, it could contain "Starbucks, Manhatten" vs. "Starbucks, Bronx". Sorry if the examples sound stupid, I never was in New York). For exact address information, you need to fetch the place details through the link in the href field in the search response.

    3) Unit of distance is meters, cf. http://developer.here.com/docs/place...pe-search.html and http://developer.here.com/docs/place...-contexts.html. Please be aware, that in case of a location context supplied by X-Map-Viewport, the distance field will be missing.

    You can find documentation at http://developer.here.com/places. To get information of certain types in the response, you can also click on the type links (if you fetch it through a web browser).

    Best,
    daniel.
    Last edited by danielmoor; 2013-03-13 at 05:39.
    Daniel Moor
    Nokia Places API

Similar Threads

  1. In a search response I see a distance parameter. What type of unit is this?
    By fromplacetoplace in forum [Archived] Places API
    Replies: 2
    Last Post: 2013-03-13, 04:58
  2. Search -> Repeat search -> Post new thread
    By krzysztof.kucharewicz in forum Feedback on Forum Nokia's Renewal 2010
    Replies: 3
    Last Post: 2011-01-21, 11:00
  3. Possible to do service search without device search?
    By ed_welch in forum Mobile Java Networking & Messaging & Security
    Replies: 8
    Last Post: 2008-02-11, 11:35
  4. Replies: 0
    Last Post: 2003-06-04, 19:11

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •