o Fh7@sddlZddlmZddlmZddlmZmZddl m Z m Z m Z ddl mZddlmZdZd Zd d d d e fZGddde ZdS)N)partial) urlencode)ConfigurationErrorGeocoderQueryError)_DEFAULT_USER_AGENTDEFAULT_SENTINELGeocoder)Location)logger) Nominatimznominatim.openstreetmap.orgzmy-applicationzmy_app/1zmy_user_agent/1.0specify_your_app_name_herec seZdZdZhdZdZdZeeeddeddfdd Z d d Z d edd d dd ddd dd d ddZ d ed d dd dddZ ddZ ddZZS)r aNominatim geocoder for OpenStreetMap data. Documentation at: https://nominatim.org/release-docs/develop/api/Overview/ .. attention:: Using Nominatim with the default `user_agent` is strongly discouraged, as it violates Nominatim's Usage Policy https://operations.osmfoundation.org/policies/nominatim/ and may possibly cause 403 and 429 HTTP errors. Please make sure to specify a custom `user_agent` with ``Nominatim(user_agent="my-application")`` or by overriding the default `user_agent`: ``geopy.geocoders.options.default_user_agent = "my-application"``. An exception will be thrown if a custom `user_agent` is not specified. >citystatecountystreetcountry postalcodez/searchz/reverseN)timeoutproxiesdomainscheme user_agent ssl_contextadapter_factorycs~tj||||||d|d|_|jtkr'|jdtvr'td|jdd|j|j|j f|_ d|j|j|j f|_ dS)a :param int timeout: See :attr:`geopy.geocoders.options.default_timeout`. :param dict proxies: See :attr:`geopy.geocoders.options.default_proxies`. :param str domain: Domain where the target Nominatim service is hosted. :param str scheme: See :attr:`geopy.geocoders.options.default_scheme`. :param str user_agent: See :attr:`geopy.geocoders.options.default_user_agent`. :type ssl_context: :class:`ssl.SSLContext` :param ssl_context: See :attr:`geopy.geocoders.options.default_ssl_context`. :param callable adapter_factory: See :attr:`geopy.geocoders.options.default_adapter_factory`. .. versionadded:: 2.0 )rrrrrr/z User-AgentaUsing Nominatim with default or sample `user_agent` "%s" is strongly discouraged, as it violates Nominatim's ToS https://operations.osmfoundation.org/policies/nominatim/ and may possibly cause 403 and 429 HTTP errors. Please specify a custom `user_agent` with `Nominatim(user_agent="my-application")` or by overriding the default `user_agent`: `geopy.geocoders.options.default_user_agent = "my-application"`.z %s://%s%sN) super__init__stripr_DEFAULT_NOMINATIM_DOMAINheaders_REJECTED_USER_AGENTSrr geocode_pathapi reverse_path reverse_api)selfrrrrrrr __class__R/var/www/html/loop/nvenv/lib/python3.10/site-packages/geopy/geocoders/nominatim.pyr5s$'  zNominatim.__init__cCsd|t|fS)aV Construct geocoding request url. The method can be overridden in Nominatim-based geocoders in order to extend URL parameters. :param str base_api: Geocoding function base address - self.api or self.reverse_api. :param dict params: Geocoding params. :return: string URL. ?)joinr)r%base_apiparamsr(r(r)_construct_urlxs zNominatim._construct_urlTF) exactly_onerlimitaddressdetailslanguagegeometry extratags country_codesviewboxbounded featuretype namedetailsc st|tjjrfdd|D}nd|i}|ddi|r%d|d<n|dur9t|}|dkr5td ||d<| rC| d |d <| rId|d <| sMg} t| t rU| g} | r^d | |d<|rdd|d<| rjd|d<|rp||d<|rvd|d<|dur| }|dkrd|d<n|dkrd|d<n|dkrd|d<n |dkrd|d<nt d| r| |d< j|}tdjj|tj|d}j|||d S)!a Return a location point by address. :param query: The address, query or a structured query you wish to geocode. For a structured query, provide a dictionary whose keys are one of: `street`, `city`, `county`, `state`, `country`, or `postalcode`. For more information, see Nominatim's documentation for `structured requests`: https://nominatim.org/release-docs/develop/api/Search :type query: dict or str :param bool exactly_one: Return one result or a list of results, if available. :param int timeout: Time, in seconds, to wait for the geocoding service to respond before raising a :class:`geopy.exc.GeocoderTimedOut` exception. Set this only if you wish to override, on this call only, the value set during the geocoder's initialization. :param int limit: Maximum amount of results to return from Nominatim. Unless exactly_one is set to False, limit will always be 1. :param bool addressdetails: If you want in *Location.raw* to include address details such as house_number, city_district, postcode, etc (in a structured form) set it to True :param str language: Preferred language in which to return results. Either uses standard `RFC2616 `_ accept-language string or a simple comma-separated list of language codes. :param str geometry: If present, specifies whether the geocoding service should return the result's geometry in `wkt`, `svg`, `kml`, or `geojson` formats. This is available via the `raw` attribute on the returned :class:`geopy.location.Location` object. :param bool extratags: Include additional information in the result if available, e.g. wikipedia link, opening hours. :param country_codes: Limit search results to a specific country (or a list of countries). A country_code should be the ISO 3166-1alpha2 code, e.g. ``gb`` for the United Kingdom, ``de`` for Germany, etc. :type country_codes: str or list :type viewbox: list or tuple of 2 items of :class:`geopy.point.Point` or ``(latitude, longitude)`` or ``"%(latitude)s, %(longitude)s"``. :param viewbox: Prefer this area to find search results. By default this is treated as a hint, if you want to restrict results to this area, specify ``bounded=True`` as well. Example: ``[Point(22, 180), Point(-22, -180)]``. :param bool bounded: Restrict the results to only items contained within the bounding ``viewbox``. :param str featuretype: If present, restrict results to certain type of features. Allowed values: `country`, `state`, `city`, `settlement`. :param bool namedetails: If you want in *Location.raw* to include namedetails, set it to True. This will be a list of alternative names, including language variants, etc. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. cs i|] \}}|jvr||qSr()structured_query_params).0keyvalr%r(r) s  z%Nominatim.geocode..qformatjsonr0NzLimit cannot be less than 1z#%(lon1)s,%(lat1)s,%(lon2)s,%(lat2)sr6r7, countrycodesr1r9accept-languageTr4wkt polygon_textsvg polygon_svgkml polygon_kmlgeojsonpolygon_geojsonz@Invalid geometry format. Must be one of: wkt, svg, kml, geojson. featureTypez%s.geocode: %sr/r) isinstance collectionsabcMappingitemsupdateint ValueError_format_bounding_boxstrr+lowerrr.r"r debugr'__name__r _parse_json_call_geocoder)r%queryr/rr0r1r2r3r4r5r6r7r8r9r-urlcallbackr(r>r)geocodesl\       zNominatim.geocode)r/rr2r1zoomr9c Csz ||d\}} Wn tytdw|| dd} |r$|| d<|r(dnd| d<|d ur4|| d <|r:d| d <||j| } td |jj| t |j |d } |j | | |dS)a Return an address by location point. :param query: The coordinates for which you wish to obtain the closest human-readable addresses. :type query: :class:`geopy.point.Point`, list or tuple of ``(latitude, longitude)``, or string as ``"%(latitude)s, %(longitude)s"``. :param bool exactly_one: Return one result or a list of results, if available. :param int timeout: Time, in seconds, to wait for the geocoding service to respond before raising a :class:`geopy.exc.GeocoderTimedOut` exception. Set this only if you wish to override, on this call only, the value set during the geocoder's initialization. :param str language: Preferred language in which to return results. Either uses standard `RFC2616 `_ accept-language string or a simple comma-separated list of language codes. :param bool addressdetails: Whether or not to include address details, such as city, county, state, etc. in *Location.raw* :param int zoom: Level of detail required for the address, an integer in range from 0 (country level) to 18 (building level), default is 18. :param bool namedetails: If you want in *Location.raw* to include namedetails, set it to True. This will be a list of alternative names, including language variants, etc. .. versionadded:: 2.3 :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. rDz"Must be a coordinate pair or PointrB)latlonrArFrCrr1Nrer9z%s.reverse: %srPrQ) _coerce_point_to_stringsplitrYr.r$r r]r'r^rr_r`) r%rar/rr2r1rer9rfrgr-rbrcr(r(r)reverse+s(2 zNominatim.reversecCsT|dd}|dd}|dd}|dur"|dur"t|}t|}t|||f|S)Nrfrg display_name)getfloatr )r%placelatitude longitude placenamer(r(r) _parse_codevs   zNominatim._parse_codecsr|sdSt|tjjrd|vr|ddkrdSt|dt|tjjs'|g}|r0|dSfdd|DS)NerrorzUnable to geocodercsg|]}|qSr()rr)r;rnr>r(r) sz)Nominatim._parse_json..)rRrSrTrUrSequencerr)r%placesr/r(r>r)r_s  zNominatim._parse_json)r^ __module__ __qualname____doc__r:r!r#rrrr.rdrjrrr_ __classcell__r(r(r&r)r sJ C ) K r )collections.abcrS functoolsr urllib.parser geopy.excrrgeopy.geocoders.baserrrgeopy.locationr geopy.utilr __all__rr r r(r(r(r)s