gc1ddlmZddlmZddlmZmZmZmZm Z ddl m Z m Z ddl mZddlmZmZmZddlmZdZGd d e Zy ) )partial) urlencode)GeocoderAuthenticationFailureGeocoderInsufficientPrivilegesGeocoderQueryErrorGeocoderQuotaExceededGeocoderServiceError)DEFAULT_SENTINELGeocoder)Location)ensure_pytz_is_installedfrom_fixed_gmt_offsetfrom_timezone_name)logger)GeoNamesceZdZdZdZdZdZdZeededddd fd Z d eddd d Z d edddddZ dZ dZ eddZdZdZdZxZS)rzGeoNames geocoder. Documentation at: http://www.geonames.org/export/geonames-search.html Reverse geocoding documentation at: http://www.geonames.org/export/web-services.html#findNearbyPlaceName z /searchJSONz/findNearbyPlaceNameJSONz/findNearbyJSONz /timezoneJSONNhttpzapi.geonames.org)timeoutproxies user_agent ssl_contextadapter_factoryschemedomaincNt |||||||||_|jd||j|_|jd||j |_|jd||j|_ |jd||j|_ y)a :param str username: GeoNames username, required. Sign up here: http://www.geonames.org/login :param int timeout: See :attr:`geopy.geocoders.options.default_timeout`. :param dict proxies: See :attr:`geopy.geocoders.options.default_proxies`. :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 :param str scheme: See :attr:`geopy.geocoders.options.default_scheme`. Note that at the time of writing GeoNames doesn't support `https`, so the default scheme is `http`. The value of :attr:`geopy.geocoders.options.default_scheme` is not respected. This parameter is present to make it possible to switch to `https` once GeoNames adds support for it. :param str domain: base api domain .. versionadded:: 2.4 )rrrrrrz://N) super__init__usernamer geocode_pathapi reverse_path api_reversereverse_nearby_pathapi_reverse_nearby timezone_path api_timezone) selfrrrrrrrr __class__s X/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/geonames.pyrzGeoNames.__init__&s^ !#+  !  ;;0A0A B  ;;0A0A B  ;;0H0H I  ;;0B0B C T) exactly_onercountry country_biascd|fd|jfg}|r|jd|f|sg}t|tr|g}|D]}|jd|f|r|jddj |j t |f}tjd|jj|t|j|} |j|| | S) a Return a location point by address. :param str query: The address or query you wish to geocode. :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 country: Limit records to the specified countries. Two letter country code ISO-3166 (e.g. ``FR``). Might be a single string or a list of strings. :type country: str or list :param str country_bias: Records from the country_bias are listed first. Two letter country code ISO-3166. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. qr countryBiasr,)maxRows?z%s.geocode: %sr+r)rappend isinstancestrjoinr rrdebugr(__name__r _parse_json_call_geocoder) r'queryr+rr,r-params country_itemurlcallbacks r)geocodezGeoNames.geocodelsD%L  '   MM=,7 8G gs #iG#L MM9l3 4$  MM. )hh)F"345 %t~~'>'>D4++E""3'"BBr*findNearbyPlaceName)r+r feature_codelangfind_nearby_typecv |j|jd\}}|dk(rH|r td|j|||} dj |j t | f} n[|dk(rH|r td|j||| } dj |jt | f} ntd |ztjd |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 feature_code: A GeoNames feature code :param str lang: language of the returned ``name`` element (the pseudo language code 'local' will return it in local language) Full list of supported languages can be found here: https://www.geonames.org/countries/ :param str find_nearby_type: A flag to switch between different GeoNames API endpoints. The default value is ``findNearbyPlaceName`` which returns the closest populated place. Another currently implemented option is ``findNearby`` which returns the closest toponym for the lat/lng query. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. ,"Must be a coordinate pair or PointrDzMfind_nearby_type=findNearbyPlaceName doesn't support the `feature_code` param)latlngrFr3 findNearbyzr+rrErFrGrKrLr?rArBs r)reversezGeoNames.reversesaX C33E:@@EHC 4 4 /@@AF ((D,,i.?@AC  - R55)6F ((D33Yv5FGHC$ADTT   %t~~'>'>D4++E""3'"BBC CAB B Cs #D##D8c4|||jd}|r||d<|S)NrKrLr featureCoder)r'rKrLrEr?s r)rRz$GeoNames._reverse_find_nearby_paramss*   $0F= ! r*c4|||jd}|r||d<|S)NrUrFrW)r'rKrLrFr?s r)rQz/GeoNames._reverse_find_nearby_place_name_paramss)   !F6N r*r5ct |j|jd\}}|||jd}dj |j t|f}tjd|jj||j||j|S#t$r tdwxYw)aO Find the timezone for a point in `query`. GeoNames always returns a timezone: if the point being queried doesn't have an assigned Olson timezone id, a ``pytz.FixedOffset`` timezone is used to produce the :class:`geopy.timezone.Timezone`. :param query: The coordinates for which you want a timezone. :type query: :class:`geopy.point.Point`, list or tuple of (latitude, longitude), or string as "%(latitude)s, %(longitude)s" :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. :rtype: :class:`geopy.timezone.Timezone`. rIrJrUr3z%s.reverse_timezone: %sr5)r rNrOrPrr9r&rrr:r(r;r=_parse_json_timezone)r'r>rrKrLr?rAs r)reverse_timezonezGeoNames.reverse_timezones& !" C33E:@@EHC    hh))9V+<=> .0G0GM""3(A(A7"SS CAB B Cs #B..Cc|jd}|rP|d}|d}|jdr t||dk(r t||dvr t |t |y)Nstatusvaluemessagezuser account not enabled to use ))get startswithrrrr )r'bodyerrcoder_s r)_raise_for_errorzGeoNames._raise_for_error-sthhx  w.parse_codeRsyy-H %.II ?!),  &)IIIlD1Eii t4Gyy&w7=7q17=HHx&;UC C>s B*B*r)rdrilen)r'docr+placesrrxs r)r<zGeoNames._parse_jsonIscR( c"6{ D, fQi( (39:6%Ju%6: ::sA)r; __module__ __qualname____doc__rr!r#r%r rrCrSrRrQr[rirZr< __classcell__)r(s@r)rrs!L-L+#M %$( %D T$5Cv$2OCb2B#TJ 0 A";r*rN) functoolsr urllib.parser geopy.excrrrrr geopy.geocoders.baser r geopy.locationr geopy.timezoner rr geopy.utilr__all__rr*r)rs?"<#  T;xT;r*