Place name recognition tool (Prussia, 19th century)


API Documentation

This is a web service which currently provides the recognition of place names within texts in context of Prussia in the 19th century. This limitation results from the underlying gazetteer which was generated from BBAW's project "Protokolle des Preußischen Staatsministeriums Acta Borussica".

Its aim is to return the offset and length of recognized place names within a given text. The format of results is selectable. This service was developed by Martin Stenzel and Fabian Körner, both BBAW, and it is hosted at the Berlin-Brandenburg Academy of Sciences and Humanities.

System requirements

This tool provides its services to any kind of application that is able to send HTTP requests and (of course) handle correspondig responses (see detection API and examples). Input, processing and output are fully based on Unicode. Please keep this in mind, when generating input and handling responses.

As mentioned before, temporal and spatial restrictions occur. It would be pointless to process texts which have different contexts.

Warranty

This web service is provided WITHOUT ANY WARRANTY. Even without the implied warranty of MERCHANTABILITY or FITNESS FOR ANY PURPOSE. Because of ongoing development, changes in its runtime behavior can occur at any time without prior notice.

Recognition API

To use the service, an application (e.g. your own browser) simply sends HTTP-POST or HTTP-GET requests with a few parameters. These follow a quite simple approach, as shown below:

key allowed values description
text [unicode] Unicode character sequence that shall be searched for place names. IMPORTANT: The ampersand must be avoided here. If necessary, please apply a temporal substitution.
output xml
txt
json
Sets the response format suitable for different applications. It is optional (default: txt).

Examples

If you are an application that is able to handle plain text responses and would like to search a text for place names, please try:
https://pdrprod.bbaw.de/pdrws/places?text=Die Reise führte ihn von Eisleben über Artern (Krs. Sangerhausen) nach Erfurt.

Or if you are a researcher (able to read simple xml formats) interested in the recognition of place names in a German text, please feel free to try:
https://pdrprod.bbaw.de/pdrws/places?text=Tapiau liegt östlich von Königsberg, der Hauptstadt Ostpreußens, unweit von Wehlau.&output=xml

The result of the latter query shows a weakness of our current approach: Ostpreussens, or even better Hauptstadt Ostpreußens should have been recognized too. That is work in progress.

Documentation API

key allowed values description
doc api Sets the key of a requested documentation. The value api delivers the document you are reading now.