g7ddlZddlmZddlmZddlmZmZddl m Z m Z m Z ddl mZddlmZdZd Zd d d d e fZGdde Zy)N)partial) urlencode)ConfigurationErrorGeocoderQueryError)_DEFAULT_USER_AGENTDEFAULT_SENTINELGeocoder)Location)logger) Nominatimznominatim.openstreetmap.orgzmy-applicationzmy_app/1zmy_user_agent/1.0specify_your_app_name_herec eZdZdZhdZdZdZeeeddeddfd Z dZ d edd d dd ddd dd d d Z d ed d dd d dZ dZ dZxZS)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_factoryct||||||||jd|_|jtk(r0|j dt vrtd|j dz|jd|j|j|_ |jd|j|j|_ y)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://N) super__init__stripr_DEFAULT_NOMINATIM_DOMAINheaders_REJECTED_USER_AGENTSrr geocode_pathapi reverse_path reverse_api) selfrrrrrrr __class__s Y/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/nominatim.pyrzNominatim.__init__5sN !#+  ll3' KK4 4LL.2GG$S,,|,-  #'++t{{D`_ 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``. qformatjsonr3zLimit cannot be less than 1z#%(lon1)s,%(lat1)s,%(lon2)s,%(lat2)sr9r:, countrycodesr4r<accept-languageTr7wkt polygon_textsvg polygon_svgkml polygon_kmlgeojsonpolygon_geojsonz@Invalid geometry format. Must be one of: wkt, svg, kml, geojson. featureTypez%s.geocode: %sr2r) isinstance collectionsabcMappingitemsstructured_query_paramsupdateint ValueError_format_bounding_boxstrr.lowerrr1r%r debugr)__name__r _parse_json_call_geocoder)r(queryr2rr3r4r5r6r7r8r9r:r;r<keyvalr0urlcallbacks r*geocodezNominatim.geocodes&x e[__44 5;;=!C$666S  5\F f   F7O  JEqy !>??#F7O  $ 9 9>!@F9   !F9 M mS )*OM %(XXm% " '(F# $ $%F= ! (0F$ % "&F;   ~~'H5 )*~&U"()}%U"()}%Y&,-()(. $/F= !!!$((F3 %t~~'>'>D4++E""3'"BBKsG)r2rr5r4zoomr<c |j|jd\}} || dd} |r|| d<|rdnd| d<||| d <|rd| d <|j|j| } t j d |jj| t|j| } |j| | | S#t$r tdwxYw)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``. rBz"Must be a coordinate pair or Pointr@)latlonr?rDrArr4rfr<z%s.reverse: %srNrO) _coerce_point_to_stringsplitrXr1r'r r\r)r]rr^r_) r(r`r2rr5r4rfr<rhrir0rcrds r*reversezNominatim.reverse+sd C33E:@@EHC  (0F$ %(61A  !F6N $%F= !!!$"2"2F; %t~~'>'>D4++E""3'"BB+ CAB B Cs #B;;Cc|jdd}|jdd}|jdd}||t|}t|}t|||f|S)Nrhri display_name)getfloatr )r(placelatitude longitude placenames r* _parse_codezNominatim._parse_codevsd99UD)IIeT* IInd3  I$9XHi(I Hi#8%@@r+cH|syt|tjjrd|vr|ddk(ryt |dt|tjj s|g}|r|j |dS|Dcgc]}|j |c}Scc}w)NerrorzUnable to geocoder)rPrQrRrSrSequenceru)r(placesr2rqs r*r^zNominatim._parse_jsons fkoo55 67f;Lg"55(99&+//":":;XF ##F1I. .9?@D$$U+@ @@sB)r] __module__ __qualname____doc__rUr$r&rr!rr1rerlrur^ __classcell__)r)s@r*r r s"LL %$,( AWF 7&$ bCP$ICVAAr+r )collections.abcrQ functoolsr urllib.parser geopy.excrrgeopy.geocoders.baserrr geopy.locationr geopy.utilr __all__r!r#r r+r*rsQ"<PP# 9  yAyAr+