Skip to main content

Pygeonlp WebAPI Server

Project description

pygeonlp-webapi, A json-rpc webapi server for pygeonlp

pygeonlp-webapi is a WSGI module to use pygeonlp features as a JSON-RPC web service.

How To Use

The server for development using Flask can be run with the following command.

$ python -m


$ FLASK_APP="" flask run --port=5000

If you prefer gunicorn, you can run the following command.

$ gunicorn --bind=

Then, post a JSON-RPC message to the server.

$ curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "geonlp.parse", "params":{"sentence":"NIIは千代田区にあります。"}, "id":"1"}' http://localhost:5000/api

More detailed Japanese documentation of the software including API is available under /doc directory. You can also find the latest online documentation at Web Service section in GeoNLP Documentation.


pygeonlp-webapi requires pygeonlp and flask-jsonrpc.


The pygeonlp-webapi package can be installed with the pip command. It is recommended that you upgrade pip and setuptools to the latest versions before running it.

$ pip install --upgrade pip setuptools
$ pip install pygeonlp-webapi

The database needs to be prepared the first time.

Prepare the database

Execute the command to register the basic place name word analysis dictionaries (*.json, *.csv) in this package into the database under the default diretory.

>>> import pygeonlp.api as api
>>> api.setup_basic_database()

Run tests (Optional)

Run the unit tests with pytest command.


Use pip command to uninstall.

$ pip uninstall pygeonlp-webapi


The 2-Clause BSD License


This software is supported by DIAS (Data Integration and Analysis System) and ROIS-DS CODH (Center for Open Data in the Humanities).

It was also supported by JST (Japan Science and Technology Agency) PRESTO program.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (12.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page