This release contains a lot of public API cleanup. Also make sure to

check out the updated docs! A new `Semver` doc section has been added,
explaining the geopy's policy on breaking changes.

*   ADDED: Nominatim geocoder now supports an `addressdetails` option in
    the `reverse` method.
    Contributed by Serphentas. (geopy#285)

*   ADDED: ArcGIS geocoder now supports an `out_fields` option in
    the `geocode` method.
    Contributed by Jonathan Batchelor. (geopy#227)

*   ADDED: Yandex geocoder now supports a `kind` option in the
    `reverse` method.

*   ADDED: Some geocoders were missing `format_string` option. Now all
    geocoders support it.

*   ADDED: `geopy.distance.lonlat` function for conveniently converting
    `(x, y, [z])` coordinate tuples to the `Point` instances, which use
    `(y, x, [z])`.
    Contributed by svalee. (geopy#282)

*   ADDED: `geopy.geocoders.options` object, which allows to configure
    geocoder defaults (such as User-Agent, timeout, format_string)
    application-wide. (geopy#288)

*   ADDED: Support for supplying a custom SSL context. See docs for
    `geopy.geocoders.options.default_ssl_context`. (geopy#291)

*   ADDED: Baidu geocoder was missing the `exactly_one` option in its `reverse`
    method.

*   ADDED: GeocodeFarm now supports a `scheme` option.

*   CHANGED: Baidu and Yandex geocoders now use https scheme by default
    instead of http.

*   CHANGED: ArcGIS geocoder was updated to use the latest API.
    Please note that `Location.raw` results for `geocode` have changed
    a little due to that.
    Contributed by Jonathan Batchelor. (geopy#227)

*   CHANGED: Explicitly passed `timeout=None` in geocoder calls now
    issues a warning. Currently it means "use geocoder's default timeout",
    while in geopy 2.0 it would mean "use no timeout". (geopy#288)

*   CHANGED: GoogleV3 `geocode` call now supports `components` without
    `query` being specified. (geopy#296)

*   CHANGED: GeoNames, GoogleV3, IGNFrance, OpenCage and Yandex erroneously
    had `exactly_one=False` by default for `reverse` methods, which must have
    been True. This behavior has been kept, however a warning will be issued
    now unless `exactly_one` option is explicitly specified in `reverse` calls
    for these geocoders. The default value will be changed in geopy 2.0. (geopy#295)

*   CHANGED: Point now throws a `ValueError` exception instead of normalizing
    latitude and tolerating NaN/inf values for coordinates. (geopy#294)

*   CHANGED: `Vincenty` usage now issues a warning. `Geodesic` should be used
    instead. Vincenty is planned to be removed in geopy 2.0. (geopy#293)

*   CHANGED: ArcGIS `wkid` option for `reverse` call has been deprecated
    because it was never working properly, and it won't, due to
    the coordinates normalization in Point.

*   FIXED: ArcGIS and What3Words did not respect `exactly_one=False`.
    Now they respect it and return a list of a single location in this case.

*   FIXED: ArcGIS was throwing an exception on empty response of `reverse`.
    Now `None` is returned, as expected.

*   FIXED: `GeocodeFarm` was raising an exception on empty response instead
    of returning `None`. Contributed by Arthur Pemberton. (geopy#240)

*   FIXED: `GeocodeFarm` had missing `Location.address` value sometimes.

*   REMOVED: `geopy.geocoders.DEFAULT_*` constants (in favor of
    `geopy.geocoders.options.default_*` attributes). (geopy#288)

*   REMOVED: YahooPlaceFinder geocoder. (geopy#283)

*   REMOVED: GeocoderDotUS geocoder. (geopy#286)

* ADDED: Pickpoint geocoder. Contributed by Vladimir Kalinkin. (geopy…

…#246)

*   ADDED: Bing geocoder: additional parameters for geocoding (`culture`
    and `include_country_code`). Contributed by Bernd Schlapsi. (geopy#166)

*   ADDED: `Point` and `Location` instances are now picklable.

*   ADDED: More accurate algorithm for distance computation
    `geopy.distance.geodesic`, which is now a default
    `geopy.distance.distance`. Vincenty usage is now discouraged in favor of
    the geodesic. This also has added a dependency of geopy on
    `geographiclib` package. Contributed by Charles Karney. (geopy#144)

*   ADDED: Nominatim geocoder now supports a `limit` option and uses `limit=1`
    for `exactly_one=True` requests. Contributed by Serphentas. (geopy#281)

*   CHANGED: `Point` now issues warnings for incorrect or ambiguous inputs.
    Some of them (namely not finite values and out of band latitudes)
    will be replaced with ValueError exceptions in the future versions
    of geopy. (geopy#272)

*   CHANGED: `Point` now uses `fmod` instead of `%` which results in more
    accurate coordinates normalization. Contributed by svalee. (geopy#275, geopy#279)

*   CHANGED: When using http proxy, urllib's `install_opener` was used, which
    was altering `urlopen` call globally. It's not used anymore.

*   CHANGED: `Point` now raises `ValueError` instead of `TypeError` when more
    than 3 arguments have been passed.

*   FIXED: `Point` was raising an exception when compared to non-iterables.

*   FIXED: Coordinates of a `Point` instance changed via `__setitem__` were
    not updating the corresponding lat/long/alt attributes.

*   FIXED: Coordinates of a `Point` instance changed via `__setitem__` were
    not being normalized after assignment. Note, however, that attribute
    assignments are still not normalized. (geopy#272)

*   FIXED: `Distance` instances comparison was not working in Python3.

*   FIXED: Yandex geocoder was sending API key with an incorrect parameter.

*   FIXED: Unit conversions from feet were incorrect.
    Contributed by scottessner. (geopy#162)

*   FIXED: Vincenty destination function had an error in the formula
    implementation. Contributed by Hanno Schlichting. (geopy#194)

*   FIXED: Vincenty was throwing UnboundLocalError when difference between
    the two longitudes was close to 2*pi or either of them was NaN. (geopy#187)

*   REMOVED: `geopy.util.NullHandler` logging handler has been removed.

* ADDED: Mapzen geocoder. Contributed by migurski. (geopy#183)

*   ADDED: GoogleV3 geocoder now supports a `channel` option.
    Contributed by gotche. (geopy#206)

*   ADDED: Photon geocoder now accepts a new `limit` option.
    Contributed by Mariana Georgieva.

*   CHANGED: Use the IUGG mean earth radius for EARTH_RADIUS.
    Contributed by cffk. (geopy#151)

*   CHANGED: Use the exact conversion factor from kilometers to miles.
    Contributed by cffk. (geopy#150)

*   CHANGED: OpenMapQuest geocoder now properly supports `api_key`
    option and makes it required.

*   CHANGED: Photon geocoder: removed `osm_tag` option from
    reverse geocoding method, as Photon backend doesn't support
    it for reverse geocoding.

*   FIXED: Photon geocoder was always returning an empty address.

*   FIXED: Yandex geocoder was returning a truncated address
    (the `name` part of a place was missing).

*   FIXED: The custom `User-Agent` header was not actually sent.
    This also fixes broken Nominatim, which has recently banned
    the stock urllib user agent.

*   FIXED: `geopy.util.get_version()` function was throwing
    an `ImportError` exception instead of returning a version string.

*   FIXED: Docs for constructing a `geopy.point.Point` were referencing
    latitude and longitude in a wrong order. Contributed by micahcochran
    and sjorek. (geopy#207 geopy#229)

*   REMOVED: Navidata geocoder has been removed.
    Contributed by medecau. (geopy#204)

* ADDED: Photon geocoder. Contributed by mthh.

* ADDED: Bing supports structured query parameters. Contributed by
    SemiNormal.

* CHANGED: Geocoders send a `User-Agent` header, which by default is
    `geopy/1.11.0`. Configure it during geocoder initialization. Contributed
    by sebastianneubauer.

* FIXED: Index out of range error with no results using Yandex. Contributed
    by facciocose.

* FIXED: Nominatim was incorrectly sending `view_box` when not requested,
    and formatting it incorrectly. Contributed by m0zes.