grddlmZddlmZddlmZmZmZddlm Z m Z ddl m Z ddl mZdZGdd e Zy ) )partial) urlencode)GeocoderAuthenticationFailureGeocoderQuotaExceededGeocoderServiceError)DEFAULT_SENTINELGeocoder)Location)logger) GeocodeFarmcleZdZdZdZdZ deededddfd Zdedd Zdedd Z d Z d Z d Z xZ S)r zGeocoder using the GeocodeFarm API. Documentation at: https://www.geocode.farm/geocoding/free-api-documentation/ z/v3/json/forward/z/v3/json/reverse/N)timeoutproxies user_agent ssl_contextadapter_factoryschemect |||||||||_d}|jd||j|_|jd||j |_y)a( :param str api_key: (optional) The API key required by GeocodeFarm to perform geocoding requests. :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`. )rrrrrrzwww.geocode.farmz://N)super__init__api_keyr geocode_pathapi reverse_path reverse_api) selfrrrrrrrdomain __class__s [/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/geocodefarm.pyrzGeocodeFarm.__init__sqJ !#+   #;;0A0A B  ;;0A0A B T) exactly_onerc8d|i}|jr|j|d<dj|jt|f}t j d|j j|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. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. addrkey?z%s.geocode: %sr!r) rjoinrrr debugr__name__r _parse_json_call_geocoder)rqueryr!rparamsurlcallbacks rgeocodezGeocodeFarm.geocodePs$ E  << LLF5Mhh)F"345 %t~~'>'>D4++E""3'"BBr c |j|jd\}}||d}|jr|j|d<dj |j t |f}tjd|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. GeocodeFarm's API will always return at most one result. :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: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. ,z"Must be a coordinate pair or Point)latlonr$r%z%s.reverse: %sr&r')_coerce_point_to_stringsplit ValueErrorrr(rrr r)rr*rr+r,) rr-r!rr4r5r.r/r0s rreversezGeocodeFarm.reverseks* C33E:@@EHC  << LLF5Mhh(()F*;<= %t~~'>'>D4++E""3'"BB CAB B Cs #CCcg}|jdD]}|jdi}|jdi}|jdd}|jdd}|jdd}||jdd}||jdd}|r|rt|}t|}|jt|||f||S) NRESULTS COORDINATESADDRESSlatitude longitudeaddress_returnedaddressformatted_address)getfloatappendr ) rresultsplacesresult coordinatesrAr>r? placenames r _parse_codezGeocodeFarm._parse_codeskk),F **]B7KjjB/G"z48H# T:I $6=I #KK 48  "JJ':DA I ?!), MM(9x.CVL M- r c|y|d}|j|d|jdijddvry|j|}|r|dS|S)Ngeocoding_results NO_RESULTSSTATUSstatusr)_check_for_api_errorsrCrK)r api_resultr!rMrGs rr+zGeocodeFarm._parse_jsonso  &':; ""#45 ,002>BB8RP P!!"34 !9 Mr c|jdi}d|jddvry|jdddk(}|s<|jd}ttd}|j|t}||y) zc Raise any exceptions if there were problems reported in the api response. rOrNrPrQNSUCCESSaccess)API_KEY_INVALIDOVER_QUERY_LIMIT)rCrrr)rrM status_resultapi_call_success access_erroraccess_error_to_exception exception_clss rrRz!GeocodeFarm._check_for_api_errorss *--h; =,,Xr: : (,,Xr:iG(,,X6L#@$9) %6992M - - r )N)r* __module__ __qualname____doc__rrrrr1r9rKr+rR __classcell__)rs@rr r sd 'L&L4 %$( 4 l-1:JC6-1:J"CH& .r r N) functoolsr urllib.parser geopy.excrrrgeopy.geocoders.baserr geopy.locationr geopy.utilr __all__r r rrjs3" <# s.(s.r