joacub/geonames-server

ZF2 module, index geonames data & provides a search API using Elasticsearch

GeonamesServer

Introduction

GeonamesServer is ZF2 module. It indexes geonames data & provides a search API using Elasticsearch.
Elasticsearch is a distributed, RESTful, open source search server based on Apache Lucene., _(*1)

→ Demo
→ Composer package, _(*2)

Elasticsearch index mapping

{
    "geonameid": "2988507",
    "country": "FR",
    "name": "Paris",
    "latitude": "48.85341",
    "longitude": "2.3488",
    "population": 2138551,
    "timezone": "Europe/Paris",
    "type": "city",
    "parents": [
        {
            "geonameid": "2968815",
            "name": "Paris",
            "country": "FR",
            "type": "ADM2"
        },
        {
            "geonameid": "3012874",
            "name": "Île-de-France",
            "country": "FR",
            "type": "ADM1"
        },
        {
            "geonameid": "3017382",
            "name": "France",
            "country": "FR",
            "type": "country"
        }
    ]
}

Module installation

1. install elasticsearch
2. cd my/project/directory

3. create a composer.json file with following contents:, _(*3)

   json { "require": { "ghislainf/geonames-server": "dev-master" } }, _(*4)

4. install composer via curl -s http://getcomposer.org/installer | php (on windows, download http://getcomposer.org/installer and execute it with PHP)
5. run php composer.phar install

6. open my/project/directory/configs/application.config.php and add the following key to your modules:, _(*5)

   php 'GeonamesServer',, _(*6)

7. copy config/geonamesserver.local.php in my/project/directory/config/autoload
8. edit my/project/directory/config/autoload/geonamesserver.local.php, let yourself guided by comments.

9. import geonames data in your elasticsearch index :, _(*7)

   shell $ php public/index.php geonames_install, _(*8)

   , _(*9)

Use API

Search :

GET /geonames/_search/{string_query}
GET /geonames/_search/{string_query}/{page}
GET /geonames/_search/{string_query}/{page}/{size}, _(*10)

{page} and {size} are optional, by default {page} = 1 and {size} = 10, _(*11)

Get document :

GET /geonames/_get/{geonameid}
GET /geonames/_get/{geonameid},{geonameid},.., _(*12)