a }c7@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.0Zspecify_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. >ZstreetZ postalcodeZcountrystateZcityZcountyz/searchz/reverseN)timeoutproxiesdomainscheme user_agent ssl_contextadapter_factorycs~tj||||||d|d|_|jtkrN|jdtvrNtd|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 )rr rrrr/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)selfr rrrrrr __class__U/var/www/html/django/DPS/env/lib/python3.9/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)rZbase_apiparamsr"r"r#_construct_urlxs zNominatim._construct_urlTF) exactly_oner limitaddressdetailslanguagegeometry extratags country_codesviewboxbounded featuretype namedetailsc st|tjjr&fdd|D}nd|i}|ddi|rJd|d<n(|durrt|}|dkrjtd ||d<| r| d |d <| rd|d <| sg} t| t r| g} | rd | |d<|rd|d<| rd|d<|r||d<|rd|d<|durV| }|dkrd|d<nD|dkr&d|d<n0|dkr:d|d<n|dkrNd|d<nt d| rd| |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).0keyvalrr"r# s z%Nominatim.geocode..qformatjsonr)NzLimit cannot be less than 1z#%(lon1)s,%(lat1)s,%(lon2)s,%(lat2)sr/r0,Z countrycodesr*r2accept-languageTr-ZwktZ polygon_textsvgZ polygon_svgZkmlZ polygon_kmlZgeojsonZpolygon_geojsonz@Invalid geometry format. Must be one of: wkt, svg, kml, geojson.r1z%s.geocode: %sr(r ) isinstance collectionsabcMappingitemsupdateint ValueErrorZ_format_bounding_boxstrr%lowerrr'rr debugr!__name__r _parse_json_call_geocoder)rqueryr(r r)r*r+r,r-r.r/r0r1r2r&urlcallbackr"r7r#geocodesl\            zNominatim.geocode)r(r r+r*zoomr2c Csz||d\}} Wnty2tdYn0|| dd} |rL|| d<|rTdnd| d<|d url|| d <|rxd| 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``. r=z"Must be a coordinate pair or Pointr;)latlonr:r>r<rr*NrTr2z%s.reverse: %sr@rA) Z_coerce_point_to_stringsplitrIr'rr rLr!rMrrNrO) rrPr(r r+r*rTr2rUrVr&rQrRr"r"r#reverse+s&2 zNominatim.reversecCsT|dd}|dd}|dd}|durD|durDt|}t|}t|||f|S)NrUrVZ display_name)getfloatr )rplaceZlatitudeZ longitudeZ placenamer"r"r# _parse_codevs   zNominatim._parse_codecsv|sdSt|tjjr:d|vr:|ddkr.dSt|dt|tjjsN|g}|r`|dSfdd|DSdS)NerrorzUnable to geocodercsg|]}|qSr")r\)r4r[r7r"r# z)Nominatim._parse_json..)rBrCrDrErSequencer\)rZplacesr(r"r7r#rNs  zNominatim._parse_json)rM __module__ __qualname____doc__r3rrrrrr'rSrXr\rN __classcell__r"r"r r#r sH C ) K r )collections.abcrC functoolsr urllib.parserZ geopy.excrrZgeopy.geocoders.baserrrZgeopy.locationr Z geopy.utilr __all__rrr r"r"r"r#s