Provide JSON-API for search

[stefan-niedermann]

There should be an API for searching for addresses.
Otherwise every client would have to implement searching in contacts etc. itself. Providing an API would save every client much work.

[v1r0x]

There was an API, but didn't work for me anymore, so I removed it in #111 .
But bring it back could definitaly something for the 0.2 milestone. Currently we focus on the basic functionality, which IMO doesn't include such "advanced" stuff. Hope you can wait a bit for a solution.

[stefan-niedermann]

No problem. I'd be interessted in developing an android client if the app is stable. (Does not make sense yet). I'll keep an eye on this project :) Happy coding

[Henni]

Maybe we can gather suggestions about what the API should offer.
@stefan-niedermann what should the API provide in your opinion?

[stefan-niedermann]

Sure, this should be read as "WiP", just brainstorming.

Request

GET /search?q=<string>

Response

ownCloud Maps should search all reachable information in the ownCloud (especially from ownCloud Contacts, but maybe from ownCloud Calendar - Meetings in the near future?). And it should search osm via nominatim to get PoIs.
Mimetype: application/json

{
  /* Contacts from contacts app */
  contacts : [
      {
        firstname : <string>,
        lastname : <string>,
        address : {
          nr : <int>,
          street : <string>,
          plz : <int>,
          city : <string>
        },
        lat : <int>,
        long : <int>
      },
      ...
  ],
  /* Points of Interest (bars, clubs, toilets, buildings, ...) */
  poi : [
      {
        title : <string>,
        type : <string>, /* Enum? */
        address : {
          nr : <int>,
          street : <string>,
          plz : <int>,
          city : <string>
        },
        lat : <int>,
        long : <int>
      },
      ...
  ],
  /* Addresses from OSM search */
  addresses : [
    {
      /* Whatever the OSM JSON-API delivers ;-) */
    },
    ...
  ]
}