]> git.openstreetmap.org Git - nominatim.git/blob - docs/api/Faq.md
allow nginx to serve files without php extensions
[nominatim.git] / docs / api / Faq.md
1 # Frequently Asked Questions
2
3 ## API Results
4
5 #### 1. The address of my search results contains far-away places that don't belong there.
6
7 Nominatim computes the address from two sources in the OpenStreetMap data:
8 from administrative boundaries and from place nodes. Boundaries are the more
9 useful source. They precisely describe an area. So it is very clear for
10 Nominatim if a point belongs to an area of not. Place nodes are more complicated.
11 These are only points without any precise extend. So Nominatim has to take a
12 guess and assume that an address belongs to the closest place nose it can find.
13 In an ideal world, Nominatim would not need the place nodes but there are
14 many places on earth where there are not precise boundaries available for
15 all parts that make up an address. This is in particular true for the more
16 local address parts, like villages and suburbs. Therefore it is not possible
17 to completely dismiss place nodes. And sometimes they sneak in where they
18 don't belong.
19
20 As a OpenStreetMap mapper, you can improve the situation in two ways: if you
21 see a place node for which already an administrative area exists, then you
22 should _link_ the two by adding the node with a 'label' role to the boundary
23 relation. If there is no administrative area, you can add the approximate
24 extend of the place and tag it place=<something> as well.
25
26 #### 2. When doing reverse search, the address details have parts that don't contain the point I was looking up.
27
28 There is a common misconception how the reverse API call works in Nominatim.
29 Reverse does not give you the address of the point you asked for. Reverse
30 returns the closest object to the point you asked for and then returns the
31 address of that object. Now, if you are close to a border, then the closest
32 object may be across that border. When Nominatim then returns the address,
33 contains the county/state/country across the border.
34
35 #### 3. I get different counties/states/countries when I change the zoom parameter in the reverse query. How is that possible?
36
37 This is basically the same problem as in the previous answer.
38 The zoom level influences at which [search rank](https://wiki.openstreetmap.org/wiki/Nominatim/Development_overview#Country_to_street_level) Nominatim starts looking
39 for the closest object. So the closest house number maybe on one side of the
40 border while the closest street is on the other. As the address details contain
41 the address of the closest object found, you might sometimes get one result,
42 sometimes the other for the closest point.
43