prepare for release 3.1.0

Merge pull request #884 from lonvia/docs-tomkdocs

Switch to mkdocs for building documentation

improve syntax highlighting for vagrant scripts

update vagrant scripts

use mkdocs for compiling the documentation

Requires to shuffle around the documentation.
make doc will now compile the documentation
in the build directory. The markdowns created
from the vagrant files are no longer versioned.

update US postcode file from 2017 Tiger data

Location has been computed as the centroid over all
lines of a given postcodes. Then all postcodes which
cover a radius of more than 0.9 have been removed.

convert remaining http links and shorten copyright URL

replace non-standard uint type with unsigned

See #879.

move nominatim.org links to https

Solves #737.

Merge pull request #874 from lonvia/check-for-updates

Add function to check if new updates are available

update drop list for new postcode table

Fixes #875.

fix setup when no us_postcode is available

update URLs in code and documentation

Use https for all openstreetmap addresses, remove defunct
mapquest link and redirect documentation links to
nominatim.org.

switch default replication source to https

add function to check if new updates are available

Merge pull request #868 from JonathanMontane/feat/export

feat(export): added linked_place_id as an attribute to feature element

feat(export): added linked_place_id as an attribute to feature element

assume name for special operator in bounded search

With bounded=1 we already have a restricted area, so it does
not make sense to interpret the query as a near search.

Fixes #311.

Gives preference to special terms like postcode and housenumber

Fixes #846.

show by default all entries from the broken polygon list

Fixes #854.

Give higher penalty to partial search terms

Avoids that the interpreation of a term as partial term
is ranked higher than as a special term like postcode
or house number.

Fixes #847.

add documentation for new word count compute

add function to recalculate counts for full-word search term

when linking waterway ways and relations allow all river-like types

Fixes #848

fix address walk-up for reverse

Fixes the row for the join and completely drops parts that have
a linked_place_id.

Fixes #859.

Merge pull request #843 from matejkrajcovic/patch-1

Fix typos in introduction.php

Fix typos in introduction.php

precomputed postcodes must use dedicated import function

Merge pull request #842 from mtmail/updated-tiger-county-json-file

update utils/tiger_county_fips.json data

update utils/tiger_county_fips.json data

Merge branch 'fix-map-on-details-page' of https://github.com/mtmail/Nominatim into mtmail-fix-map-on-details-page

UI: minimap causes main map not to initialize

UI: minimap causes main map not to initialize

UI: minimap causes main map not to initialize

ignore linked places for address details

Fixes #816.

allow unnamed roads for reverse geocoding

Should avoid that results are too far off in areas where
most roads are unnamed.

ignore linked places for reverse geocoding

Fixes #838.

Merge pull request #835 from lonvia/fix-quoting

Replace double quoting with single quotes

replace double-quoting with single quotes where applicable

PHP code style rule to enforce single quotes

Merge pull request #834 from mtmail/tests-for-closest-housenumber

tests for lib.php closestHouseNumber

tests for lib.php closestHouseNumber

restrict number of results for reverse queries

When given a coordinate off the coast of a large town, the entire
town may end up in the potential results during the reverse query.
Postgres then needs to sort tens of thousands of results before it
can determine the clostest one. Given that the results at such a
large search radius are bound to be imprecise anyway, restrict
the number of results postgres should consider to 1000.

fix variable typo when filtering results

Fixes #830 and #832.

placex must not return a lookup housenumber

penalize housenumber after the postcode

fix uninitialised rank variable when regrouping searches

revert use of global penalty for a search direction

Adding a penalty to a search description because there
is a term at the beginning which looks like a country
turned out to be a bad idea as there are too many
abbreviations around that match against frequently
matched words.

tiger import: convert counties to str

For python2 the gdal features come out as str and
cannot be combined with unicode strings.

huge cleanup of tigerAddressImport.py

huge cleanup of tigerAddressImport.py

Merge pull request #829 from lonvia/result-as-a-class

Use PlaceLookup in search for retriving place details

use PlaceLookup::loadParamArray in search and lookup

add loadParamArray function to PlaceLookup and use for reverse

use PlaceLookup in search

make PlaceLookup::lookup() accept multiple results

replace SQL code in PlaceLookup with content of search's get_details

use Result class in reverse geocoding

Also simplifies the reverse algorithm slightly by no longer
having an additional distance lookup.

introduce Result class in Geocode and SearchDescription

Merge pull request #822 from mtmail/ui-allow-copypaste-combined-latlon

Ui allow copypaste combined latlon

Merge pull request #819 from mtmail/tiger-2017-import

Tiger 2017 data no longer contains -divroad- field

UI: allow copy&pasting lat,lon into the lat search field

UI: allow copy&pasting lat,lon into the lat search field

Merge pull request #821 from mtmail/ui-scrollwheel-minimap

UI: scrollwheel, minimap

UI: scrollwheel, minimap

Merge pull request #820 from mtmail/php-test-path-changed

Vagrant documentation: update path to php tests

Vagrant documentation: update path to php tests

Tiger 2017 data no longer contains -divroad- field

Merge pull request #814 from lonvia/phrase-as-a-class

Make phrases a class and add early checking of token validity

adapt unit tests to new Phrase class

fix CodeSniffer offences

move word recheck into token collection

Drop tokens for special and postcode searches already when
collecting them for ValidTokens when they cannot be found
in the normalized query.

simplify cross-check of country tokens

Drop country tokens that do not match the country code list
early. Remove in turn the special country code check for
structured phrases. It is sufficient to do this during
word list building.

remove unused $aPossibleMainWordIDs array

add documentation for Phrase

take frequency scores from token description

No need to hand them in separately.

convert phrase array to class

take country names only from relations

Show address rank in details and hide unset admin_level

Address rank explains better why the address parts are where
they are.

Fixes #766.

Sort results for near searches by proximity

If a reference coordinate is given, results really should be
sorted by distance to this point ignoring importance completely.

Fixes #796.

Merge pull request #812 from lonvia/search-as-a-class

Refactoring Search arrays

documentation for SearchContext and SearchDescription

coding style and some documentation

move complete search query code into SearchDescription

adapt phpunit tests to new SearchContext class

move country list to SearchContext

move excluded place list to SearchContext

move viewbox sql to new SearchContext

replace NearPoint with a more generic context object

The NearPoint is actually common to all SearchDescriptions
and there is other context data as well. like viewbox, that
needs to be available to the search object but is common.

don't trust words from word table to be sanatized

add missing include

fix CodeSniffer violations

fix more syntax issues

move Search dump function into SearchDescription class

fix syntax errors from introduction of  SearchDescription

convert getGroupedSearches to SearchDescription class

add function to convert array to SQL

use SearchDescription class in query loop

move initial search setup to new class type

add new class for searches