Tags: silenceTiano/geopy
Tags
- Add support for leading plus sign in the `.Point` constructor. Contributed by Azimjon Pulatov. (geopy#448) - `.GoogleV3`: change missing `api_key` warning to an error. (geopy#450) - Fixed an undocumented breaking change in geopy 2.0.0, where the `.Distance` class has become abstract, thus it could no longer be used for unit conversions. (geopy#435) - `.Photon` incorrectly treated 0.0 coordinate as an empty response. Contributed by Mateusz Konieczny. (geopy#439) - `.Nominatim`: fix TypeError on empty `reverse` result. (geopy#455) - Add Python 3.9 to the list of supported versions. - `.Bing`: change `postalcode` to `postalCode`. Contributed by zhongjun-ma. (geopy#424) - `.Nominatim`: better describe what is returned in addressdetails. Contributed by Mateusz Konieczny. (geopy#429) - `.Nominatim`: better describe `viewbox` param behavior. Contributed by Hannes. (geopy#454) - `.Yandex`: remove attention block about requiring an API key.
geopy 2.0 is a major release with lots of cleanup and inner refactori…
…ngs.
The public interface of the library is mostly the same, and the set
of supported geocoders didn't change.
If you have checked your code on the latest 1.x release with enabled
warnings (i.e. with `-Wd` key of the `python` command) and fixed
all of them, then it should be safe to upgrade.
New Features
~~~~~~~~~~~~
- `geopy.adapters` module. Previously all geocoders used `urllib`
for HTTP requests, which doesn't support keepalives. Adapters is
a new mechanism which allows to use other HTTP client implementations.
There are 3 implementations coming out of the box:
+ `geopy.adapters.RequestsAdapter` -- uses `requests` library
which supports keepalives (thus it is significantly more effective
than `urllib`). It is used by default if `requests` package
is installed.
+ `geopy.adapters.URLLibAdapter` -- uses `urllib`, basically
it provides the same behavior as in geopy 1.x. It is used by default if
`requests` package is not installed.
+ `geopy.adapters.AioHTTPAdapter` -- uses `aiohttp` library.
- Added optional asyncio support in all geocoders via
`.AioHTTPAdapter`, see the new `Async Mode`
doc section.
- `.AsyncRateLimiter` -- an async counterpart of `.RateLimiter`.
- `.RateLimiter` is now thread-safe.
Packaging Changes
~~~~~~~~~~~~~~~~~
- Dropped support for Python 2.7 and 3.4.
- New extras:
+ `geopy[requests]` for `geopy.adapters.RequestsAdapter`.
+ `geopy[aiohttp]` for `geopy.adapters.AioHTTPAdapter`.
Breaking Changes
~~~~~~~~~~~~~~~~
- `geopy.distance` algorithms now raise `ValueError` for points with
different altitudes, because altitude is ignored in calculations.
- Removed `geopy.distance.vincenty`, use `geopy.distance.geodesic` instead.
- `timeout=None` now disables request timeout, previously
a default timeout has been used in this case.
- Removed `GoogleV3.timezone`, use `.GoogleV3.reverse_timezone` instead.
- Removed `format_string` param from all geocoders.
See `Specifying Parameters Once` doc section for alternatives.
- `exactly_one`'s default is now `True` for all geocoders
and methods.
- Removed service-specific request params from all `__init__` methods
of geocoders. Pass them to the corresponding `geocode`/`reverse`
methods instead.
- All bounding box arguments now must be passed as a list of two Points.
Previously some geocoders accepted unique formats like plain strings
and lists of 4 coordinates -- these values are not valid anymore.
- `.GoogleV3.reverse_timezone` used to allow numeric `at_time` value.
Pass `datetime` instances instead.
- `reverse` methods used to bypass the query if it couldn't be parsed
as a `.Point`. Now a `ValueError` is raised in this case.
- `.Location` and `.Timezone` classes no longer accept None
for `point` and `raw` args.
- `.Nominatim` now raises `geopy.exc.ConfigurationError` when
used with a default or sample user-agent.
- `.Point` now raises a `ValueError` if constructed from a single number.
A zero longitude must be explicitly passed to avoid the error.
- Most of the service-specific arguments of geocoders now must be passed
as kwargs, positional arguments are not accepted.
- Removed default value `None` for authentication key arguments of
`.GeoNames`, `.OpenMapQuest` and `.Yandex`.
- `parse_*` methods in geocoders have been prefixed with `_`
to explicitly mark that they are private.
Deprecations
~~~~~~~~~~~~
- :class:`.Nominatim` has been moved from ``geopy.geocoders.osm`` module
to ``geopy.geocoders.nominatim``. The old module is still present for
backwards compatibility, but it will be removed in geopy 3.
This is the last feature release for the 1.x series, as geopy 2.0 has…
… been
released. The 1.x series will not receive any new features or bugfixes
unless explicitly asked on the issue tracker.
* ADDED: `Units Conversion` docs section.
* ADDED: Docs now explicitly clarify that geocoding services
don't consider altitudes. (geopy#165)
* ADDED: `Point.format_unicode` method. It was always present as
`__unicode__` magic for Python 2.7, and now it can be accessed
as a public method.
* ADDED: `geopy.__version_info__` tuple which can be used to dynamically
compare geopy version.
* ADDED: pytest `--skip-tests-requiring-internet` switch (might be useful
for downstream package maintainers). (geopy#413)
* CHANGED: Points with different altitudes now emit a warning
in distance computations. In geopy 2.0 the warning would become
an exception. (geopy#387)
* CHANGED: Improved `Point` docs: added missing public methods,
added more examples.
* CHANGED: `Nominatim` started emitting warnings for a number of sample
user agents mentioned in the docs, such as `specify_your_app_name_here`.
* FIXED: `IGNFrance` ignored proxies with username + password auth. (geopy#289)
geopy 2.0 is a major release with lots of cleanup and inner refactori…
…ngs.
The public interface of the library is mostly the same, and the set
of supported geocoders didn't change.
If you have checked your code on the latest 1.x release with enabled
warnings (i.e. with `-Wd` key of the `python` command) and fixed
all of them, then it should be safe to upgrade.
New features
~~~~~~~~~~~~
- `geopy.adapters` module. Previously all geocoders used `urllib`
for HTTP requests, which doesn't support keepalives. Adapters is
a new mechanism which allows to use other HTTP client implementations.
There are 3 implementations coming out of the box:
+ `geopy.adapters.RequestsAdapter` -- uses `requests` library
which supports keepalives (thus it is significantly more effective
than `urllib`). It is used by default if `requests` package
is installed.
+ `geopy.adapters.URLLibAdapter` -- uses `urllib`, basically
it provides the same behavior as in geopy 1.x. It is used by default if
`requests` package is not installed.
+ `geopy.adapters.AioHTTPAdapter` -- uses `aiohttp` library.
- Added optional asyncio support in all geocoders via
`.AioHTTPAdapter`, see the new `Async Mode`
doc section.
- `.AsyncRateLimiter` -- an async counterpart of `.RateLimiter`.
- `.RateLimiter` is now thread-safe.
Packaging changes
~~~~~~~~~~~~~~~~~
- Dropped support for Python 2.7 and 3.4.
- New extras:
+ `geopy[requests]` for `geopy.adapters.RequestsAdapter`.
+ `geopy[aiohttp]` for `geopy.adapters.AioHTTPAdapter`.
Chores
~~~~~~
- `geopy.distance` algorithms now raise `ValueError` for points with
different altitudes, because altitude is ignored in calculations.
- Removed `geopy.distance.vincenty`, use `geopy.distance.geodesic` instead.
- `timeout=None` now disables request timeout, previously
a default timeout has been used in this case.
- Removed `GoogleV3.timezone`, use `.GoogleV3.reverse_timezone` instead.
- Removed `format_string` param from all geocoders.
See `Specifying Parameters Once` doc section for alternatives.
- `exactly_one`'s default is now `True` for all geocoders
and methods.
- Removed service-specific request params from all `__init__` methods
of geocoders. Pass them to the corresponding `geocode`/`reverse`
methods instead.
- All bounding box arguments now must be passed as a list of two Points.
Previously some geocoders accepted unique formats like plain strings
and lists of 4 coordinates -- these values are not valid anymore.
- `.GoogleV3.reverse_timezone` used to allow numeric `at_time` value.
Pass `datetime` instances instead.
- `reverse` methods used to bypass the query if it couldn't be parsed
as a `.Point`. Now a `ValueError` is raised in this case.
- `.Location` and `.Timezone` classes no longer accept None
for `point` and `raw` args.
- `.Nominatim` now raises `geopy.exc.ConfigurationError` when
used with a default or sample user-agent.
- `.Point` now raises a `ValueError` if constructed from a single number.
A zero longitude must be explicitly passed to avoid the error.
- Most of the service-specific arguments of geocoders now must be passed
as kwargs, positional arguments are not accepted.
- Removed default value `None` for authentication key arguments of
`.GeoNames`, `.OpenMapQuest` and `.Yandex`.
- `parse_*` methods in geocoders have been prefixed with `_`
to explicitly mark that they are private.
* ADDED: `AlgoliaPlaces` geocoder.
Contributed by Álvaro Mondéjar. (geopy#405)
* ADDED: `BaiduV3` geocoder. (geopy#394)
* ADDED: `MapQuest` geocoder.
Contributed by Pratheek Rebala. (geopy#399)
* ADDED: `MapTiler` geocoder.
Contributed by chilfing. (geopy#397)
* ADDED: `Nominatim`-based geocoders: `zoom` parameter
has been added to the `reverse` method.
Contributed by David Mueller. (geopy#406)
* ADDED: `GoogleV3` added support for lists in `components` param
which allows to specify multiple components with the same name.
Contributed by Pratheek Rebala. (geopy#409)
* CHANGED: Updated links to Nominatim documentation.
Contributed by Sarah Hoffmann. (geopy#403)
* CHANGED: `Yandex` now issues a deprecation warning when `lang`
parameter is specified in `__init__`. `lang` should be passed
to `geocode` and `reverse` instead. (geopy#350)
* CHANGED: `format_string` param has been marked as deprecated
in all geocoders and will be removed in geopy 2.0.
See the new `Specifying Parameters Once` doc section for alternatives.
* FIXED: `IGNFrance` incorrectly processed empty results: `geocode`
has been raising an `IndexError`, `reverse` was returning an empty
list. Now they both return `None`. (geopy#244)
* FIXED: `TomTom` geocoder has been raising `GeocoderInsufficientPrivileges`
exception for rate limiting errors instead of `GeocoderQuotaExceeded`.
* ADDED: `HERE` geocoder now supports the new API KEY authentication
method. The old one is marked as deprecated and now issues a warning.
Contributed by deeplook. (geopy#388)
* ADDED: `Nominatim`-based geocoders: `featuretype` parameter
has been added to the `geocode` method.
Contributed by Sergio Martín Morillas. (geopy#365)
* ADDED: `Nominatim`-based geocoders: `namedetails` parameter
has been added to the `geocode` method.
Contributed by enrique a. (geopy#368)
* ADDED: `Pelias`: `language` parameter has been added
to the `geocode` and `reverse` methods.
Contributed by Armin Leuprecht. (geopy#378)
* CHANGED: `Yandex` geocoder started to require API key for all requests
since September 2019, so a warning asking to specify a key has been
added which is issued when API key is missing.
* CHANGED (packaging): sdist now contains tests.
* FIXED: Updated link to `TomTom` Search API documentation.
Contributed by Przemek Malolepszy. (geopy#362)
* FIXED: Occasional ``KeyError('city')`` in `Geolake`.
Contributed by Dmitrii K. (geopy#373)
* FIXED: `MapBox`'s `geocode` method was ignoring the `exactly_one`
parameter. Contributed by TheRealZeljko. (geopy#358)
* FIXED: The resulting `Location`'s `raw` attribute in `MapBox`
erroneously contained a single string instead of a full service
response. This might be considered a breaking change (although
it's unlikely that the previous `raw` value was usable at all).
Contributed by Sergey Lyapustin and TheRealZeljko. (geopy#354)
* ADDED: `GoogleV3`: `place_id` arg has been added to
the `geocode` method. Contributed by Mesut Öncel. (geopy#348)
* ADDED: `Geolake`, `GeoNames`, `MapBox`, `OpenCage`, `OpenMapQuest`,
`Nominatim` and `PickPoint` geocoders now also accept Python lists
of countries instead of just a single string. (geopy#349)
* CHANGED: `geocode`-specific args have been moved to `geocode` methods
from `__init__`, and the corresponding `__init__` args has been
deprecated. The affected geocoders are: `GeocodeEarth`, `GeoNames`,
`OpenMapQuest`, `Nominatim`, `Pelias`, `PickPoint`,
`LiveAddress`. (geopy#350)
* FIXED: `OpenCage`'s `country` arg was not respected.
Contributed by Sebastian Illing. (geopy#342)
* FIXED: `GoogleV3` has erroneously been issuing a warning about
a missing api key when using premier.
Contributed by Mike Hansen. (geopy#345)
* FIXED: `GeoNames.reverse_timezone` didn't process errors returned b…
…y API
and instead was always raising obscure `KeyError` exceptions.
* FIXED: `GeoNames.reverse_timezone` raised `KeyError` for points which
don't have an assigned Olson timezone ID (e.g. Antarctica).
Now a valid `geopy.Timezone` is returned for such, where pytz timezone
is created as `pytz.FixedOffset`.
* FIXED: `GoogleV3.reverse_timezone` raised `KeyError` for points which
don't have an assigned Olson timezone ID (e.g. Antarctica).
Now `None` is returned for such requests, as Google doesn't provide
any meaningful data there.
The work on geopy 2.0 has started, see the new `geopy 2.0` doc section for more info. geopy 2.0 will drop support for Python 2.7 and 3.4. To ensure a smoother transition from 1.x to 2.0, make sure to check your code with warnings enabled (i.e. run python with the ``-Wd`` switch). * ADDED: Geolake geocoder. Contributed by Yorick Holkamp. (geopy#329) * ADDED: BANFrance (Base Adresse Nationale) geocoder. Contributed by Sébastien Barré. (geopy#336) * ADDED: TomTom and AzureMaps: `language` param has been added to the `reverse` method. * ADDED: Geonames geocoder now supports both `findNearbyPlaceName` and `findNearby` reverse geocoding methods, as chosen by a new `find_nearby_type` parameter of the `reverse` method. Contributed by svalee. (geopy#327) * ADDED: Geonames geocoder now supports returning a timezone for a particular `Point` via a new `reverse_timezone` method. Contributed by svalee. (geopy#327) * ADDED: Geonames geocoder's `reverse` method now supports new parameters: `lang` and `feature_code`. Contributed by svalee. (geopy#327) * ADDED: Geonames now supports `scheme` parameter. Although the service itself doesn't yet support `https`, it will be possible to enable `https` via this new parameter as soon as they add the support, without waiting for a new release of geopy. * CHANGED: Geonames now builds `Location.address` differently: previously it looked like `Kreuzberg, 16, DE`, now it looks like `Kreuzberg, Berlin, Germany`. * CHANGED: All warnings now specify a correct `stacklevel` so that the warnings point at the place in your code that triggered it, instead of the geopy internals. * CHANGED: All warnings with `UserWarning` category which will be removed in geopy 2.0 now have the `DeprecationWarning` category. * CHANGED: `geopy.extra.rate_limiter.RateLimiter` is no longer an experimental API. * CHANGED: `GoogleV3.timezone` now issues a deprecation warning when `at_time` is a number instead of a `datetime`. In geopy 2.0 this will become an exception. * CHANGED: `GoogleV3.timezone` method is now deprecated in favor of `GoogleV3.reverse_timezone`, which works exactly the same, except that it returns a new `geopy.Timezone` object, which is a wrapper for pytz timezone similarly to `geopy.Location`. This object also contains a raw response of the service. `GoogleV3.timezone` will be removed in geopy 2.0. (geopy#332) * CHANGED: `Point` constructor silently ignored the tail of the string if it couldn't be parsed, now it is not ignored. For example, `75 5th Avenue, NYC, USA` was parsed as `Point(75, 5)`, but now it would raise a `ValueError` exception. * FIXED: `GoogleV3.timezone` method didn't process errors returned by the API.
PreviousNext