Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
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

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc/img
es.alrocar.map.vector
es.alrocar.poiproxy.fiware.poidp
es.alrocar.poiproxy.gae
es.alrocar.poiproxy.rest
es.alrocar.poiproxy
generated/swagger-ui Updated swagger docs
test
.gitignore
.project
Dockerfile
LICENSE
NOTICE
README.md
README.mdown_old
pom.xml
test.sh

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.