Skip to content
A proxy service to retrieve POIs (Points Of Interest) from several public services (Nominatim, Mapquest, Cloudmade, Geonames, Panoramio, Ovi, Flickr, Twitter, LastFM, Wikipedia, Youtube, Foursquare, ...)
Java JavaScript CSS Other
Failed to load latest commit information.
doc/img synch with SVN trunk Jul 22, 2014
es.alrocar.map.vector Merge branch 'master' of git://github.com/Prodevelop/POIProxy Feb 16, 2016
es.alrocar.poiproxy.fiware.poidp [maven-release-plugin] prepare for next development iteration Feb 16, 2016
es.alrocar.poiproxy.gae synch with SVN trunk Jul 22, 2014
es.alrocar.poiproxy.rest Merge branch 'master' of git://github.com/Prodevelop/POIProxy May 17, 2016
es.alrocar.poiproxy Merge branch 'master' of git://github.com/Prodevelop/POIProxy Jun 27, 2016
generated/swagger-ui Removed warnings Apr 15, 2015
test More verbose smoketest Mar 26, 2015
.gitignore added target to gitignore Feb 16, 2016
.project synch with SVN trunk Jul 22, 2014
Dockerfile Docker file getting poiproxy.war from 2.0-SNAPSHOT release Mar 23, 2015
INSTALL.md Added Install guide May 25, 2015
LICENSE
NOTICE synch with SVN trunk Jul 22, 2014
README.md Fixed a bug in the API spec Oct 8, 2014
README.mdown_old Updated README Jul 22, 2014
pom.xml [maven-release-plugin] prepare for next development iteration Feb 16, 2016
test.sh added HOST and BASEPORT arguments Mar 23, 2015

README.md

POIProxy

A proxy service to retrieve POIs (Points Of Interest) from several public services (Nominatim, Mapquest, Cloudmade, Geonames, Panoramio, Ovi, Flickr, Twitter, LastFM, Wikipedia, Youtube, Minube, Buzz, Foursquare, Gowalla, ...)

What is POIProxy?

The main purpose is to have a single service that handles requests to any public POI service providing a well defined REST API. POIProxy is able to parse JSON and XML responses and serve standard GeoJSON format. Finally it has the capability to add new services by providing a configuration file.

How to build a development workspace of POIProxy (Work in progress)

Pre-requisites

Clone this repo

git clone https://github.com/Prodevelop/POIProxy.git

Alternatively you can download the zipped version of the repo

Import projects into Eclipse

Make sure you click on "Search for nested projects" in the Import Projects dialog of Eclipse. Check every project except es.alrocar.poiproxy.gae

If necessary, right click on every project with a red marker and select Maven>Update Project...

Add a new Server in Eclipse

Select Tomcat v7.0 Server

Browse to your Tomcat installation directory

Add es.alrocar.poiproxy.rest to the configured resources

Start your POIProxy instance

Check that everything works

Open this URL in your preferred browser:

http://localhost:8080/poiproxy/describeServices

API

  • Get available services

    Returns the available services registered into POIProxy and their description

    http://localhost:8080/poiproxy/describeServices

  • Browse by tile

    Returns the points inside the given tile (Z/X/Y). The tile notation is the same as [Google Maps uses][tiles_google]. http://localhost:8080/poiproxy/browse?service=panoramio&z=0&x=0&y=0&callback=whatever

  • Browse by extent

    Returns the points inside the given bounding box. The coordinate reference system is EPSG:4326

    http://localhost:8080/poiproxy/browseByExtent?service=panoramio&minX=-0.376&minY=39.47&maxX=-0.37&maxY=39.48&callback=whatever

  • Browse by lon,lat and distance

    Returns the points inside a given radius distance of a point. The coordinate reference system is EPSG:4326

    http://localhost:8080/poiproxy/browseByLonLat?service=panoramio&lon=-0.38&lat=39.46&dist=500&callback=whatever

  • Search by tile

    Returns the points inside the given tile (Z/X/Y) for the given query. The tile notation is the same as [Google Maps uses][tiles_google].

    http://localhost:8080/poiproxy/browse?service=flickr&z=0&x=0&y=0&query=search_term&callback=whatever

  • Search by extent

    Returns the points inside the given bounding box for the given query. The coordinate reference system is EPSG:4326

    http://localhost:8080/poiproxy/browseByExtent?service=flickr&minX=-0.376&minY=39.47&maxX=-0.37&maxY=39.48&query=search_term&callback=whatever

  • Search by lon,lat and distance

    Returns the points inside a given radius distance of a point for the given query. The coordinate reference system is EPSG:4326

    http://localhost:8080/poiproxy/browseByLonLat?service=flickr&lon=-0.38&lat=39.46&dist=500&query=search_term&callback=whatever

POIProxy supports JSONP by adding the parameter callbackto any request. If not provided then a JSON response is returned.

IMPORTANT: Not all services registered in POIProxy support all the API requests. Please refer to the describeServices operation to see the list of available operations per registered service.

Something went wrong with that request. Please try again.