Help:Nominatim: Difference between revisions
Infinatious (talk | contribs) Created Nominatim help page. |
fmt, links, cat |
||
| Line 1: | Line 1: | ||
{{OSMW|Nominatim|Nominatim}} is a tool used to search OpenGeofiction data and address points by {{OSMW|Geocoding|geocoding}}. Nominatim is used by the search bar on the main OpenGeofiction map. The Nominatim database and API are [[Forum:Announcements/Search & routing|hosted by infinatious]]. | |||
== | == Hosting information == | ||
Documentation for Nominatim can be found at [https://nominatim.org/release-docs/develop/api/Overview/ the Nominatim project website] | Documentation for Nominatim can be found at [https://nominatim.org/release-docs/develop/api/Overview/ the Nominatim project website]. 100% uptime is not guaranteed. | ||
Nominatim API | * [https://ogfnominatim-api.infinatio.us/ Nominatim API] | ||
* [https://ogfnominatim.infinatio.us/search.html Nominatim debug interface] | |||
* [https://status.infinatio.us/status/ext Server status] | |||
== Usage policy == | |||
== Usage | |||
Please follow the same usage policy for OpenGeofiction and the [https://operations.osmfoundation.org/policies/nominatim/ OSM Nominatim policy]. | Please follow the same usage policy for OpenGeofiction and the [https://operations.osmfoundation.org/policies/nominatim/ OSM Nominatim policy]. | ||
== FAQ == | == FAQ == | ||
=== What is Nominatim useful for? === | === What is Nominatim useful for? === | ||
Nominatim can be used to search the | Nominatim can be used to search the OpenGeofiction map for places. It allow allows for reverse search, which allows you to do a lookup on what is at particular coordinates. | ||
=== How often is the data updated? === | === How often is the data updated? === | ||
| Line 20: | Line 19: | ||
=== Why is a real-world or the wrong country displayed? === | === Why is a real-world or the wrong country displayed? === | ||
A real world country or the wrong | A real world country or the wrong OpenGeofiction country can be displayed for approximately 5 hours after the refresh process, as that is how long it takes to run the country index process. Please wait several hours and try again. | ||
=== Why am I receiving a Cloudflare error? === | === Why am I receiving a Cloudflare error? === | ||
If you are receiving a Cloudflare error, please check the status page above. Infinatious is generally aware of outages and will work to restore service as quickly as possible. If the status page is showing the service is up, please contact Infinatious. | If you are receiving a Cloudflare error, please check the status page above. Infinatious is generally aware of outages and will work to restore service as quickly as possible. If the status page is showing the service is up, please contact {{OGF user|Infinatious}}. | ||
=== Why are my places showing in the wrong administrative entity? === | === Why are my places showing in the wrong administrative entity? === | ||
This can be due to the fact that Nominatim computes a median point for every object it indexes. For example, if you have a street that goes through multiple cities without being divided into multiple segments, Nominatim will usually associated it with the "middle" city. The solution is to divide the street at every administrative boundary. For suburbs (and other small things like villages/hamlets), Nominatim will sometimes ignore the next higher admin-level (usually city/municipality) and associate it directly with the county. In that case, it is recommended to tag | This can be due to the fact that Nominatim computes a median point for every object it indexes. For example, if you have a street that goes through multiple cities without being divided into multiple segments, Nominatim will usually associated it with the "middle" city. The solution is to divide the street at every administrative boundary. For suburbs (and other small things like villages/hamlets), Nominatim will sometimes ignore the next higher admin-level (usually city/municipality) and associate it directly with the county. In that case, it is recommended to tag <code>is_in=*</code> to the corresponding relation, usually the <code>is_in:city=*</code> to the relation of the suburb/village/hamlet is enough. | ||
== Tips & tricks == | == Tips & tricks == | ||
* For nodes with place tags, include these in your relations with the <code>label</code> role. | |||
* For nodes with place tags, include these in your relations with the label role. | |||
* Divide streets and other places at each administrative boundary. | * Divide streets and other places at each administrative boundary. | ||
* Use the is_in= tag on administrative relations. | * Use the <code>is_in=</code> tag on administrative relations. ({{OSMW|Key:is_in#Improving_accuracy|more information}}). | ||
[[Category:Tools and resources]] | |||
Latest revision as of 14:03, 19 July 2024
File:OpenStreetMapW.svg Nominatim is a tool used to search OpenGeofiction data and address points by File:OpenStreetMapW.svg geocoding. Nominatim is used by the search bar on the main OpenGeofiction map. The Nominatim database and API are hosted by infinatious.
Hosting information
Documentation for Nominatim can be found at the Nominatim project website. 100% uptime is not guaranteed.
Usage policy
Please follow the same usage policy for OpenGeofiction and the OSM Nominatim policy.
FAQ
What is Nominatim useful for?
Nominatim can be used to search the OpenGeofiction map for places. It allow allows for reverse search, which allows you to do a lookup on what is at particular coordinates.
How often is the data updated?
Currently, the Nominatim database is manually refreshed weekly on Thursdays around 1500 UTC. You can check the exact time of the most recent data on the debug interface above, in the top right corner. The refresh process involves about 2 hours of downtime.
Why is a real-world or the wrong country displayed?
A real world country or the wrong OpenGeofiction country can be displayed for approximately 5 hours after the refresh process, as that is how long it takes to run the country index process. Please wait several hours and try again.
Why am I receiving a Cloudflare error?
If you are receiving a Cloudflare error, please check the status page above. Infinatious is generally aware of outages and will work to restore service as quickly as possible. If the status page is showing the service is up, please contact Infinatious.
Why are my places showing in the wrong administrative entity?
This can be due to the fact that Nominatim computes a median point for every object it indexes. For example, if you have a street that goes through multiple cities without being divided into multiple segments, Nominatim will usually associated it with the "middle" city. The solution is to divide the street at every administrative boundary. For suburbs (and other small things like villages/hamlets), Nominatim will sometimes ignore the next higher admin-level (usually city/municipality) and associate it directly with the county. In that case, it is recommended to tag is_in=* to the corresponding relation, usually the is_in:city=* to the relation of the suburb/village/hamlet is enough.
Tips & tricks
- For nodes with place tags, include these in your relations with the
labelrole. - Divide streets and other places at each administrative boundary.
- Use the
is_in=tag on administrative relations. (File:OpenStreetMapW.svg more information).