tj 8ddlZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z dZejd ej Zd ZGd d e ZGd de Zy)N)partial) urlencode)exc)DEFAULT_SENTINELGeocoder)Location)logger) What3Words What3WordsV3z-[^\W\d\_]+\.{1,1}[^\W\d\_]+\.{1,1}[^\W\d\_]+$c>ttj|S)z) Check query validity with regex )bool_MULTIPLE_WORD_REmatch)querys e/var/www/html/python-recuperauto-other/env/lib/python3.12/site-packages/geopy/geocoders/what3words.py _check_queryrs !''. //cjeZdZdZdZdZeededddfd Zdd ed d Zdd Z dd ed d Z ddZ xZ S)r zWhat3Words geocoder using the legacy V2 API. Documentation at: https://docs.what3words.com/api/v2/ .. attention:: Consider using :class:`.What3WordsV3` instead. z /v2/forwardz /v2/reverseNapi.what3words.comtimeoutproxies user_agent ssl_contextadapter_factorydomainct|d|||||||_|jd||j|_|jd||j |_y)a :param str api_key: Key provided by What3Words (https://accounts.what3words.com/register). :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 domain: base api domain .. versionadded:: 2.4 httpsschemerrrrr://Nsuper__init__api_keyr geocode_path geocode_api reverse_path reverse_api selfr%rrrrrr __class__s rr$zWhat3Words.__init__%seL !#+   *.++vt?P?PQ*.++vt?P?PQrenTlang exactly_onercvt|stjd||j|jd}dj |j t|f}tjd|jj|t|j|}|j|||S)a( Return a location point for a `3 words` query. If the `3 words` address doesn't exist, a :class:`geopy.exc.GeocoderQueryError` exception will be thrown. :param str query: The 3-word address you wish to geocode. :param str lang: two character language code as supported by the API (https://docs.what3words.com/api/v2/#lang). :param bool exactly_one: Return one result or a list of results, if available. Due to the address scheme there is always exactly one result for each `3 words` address, so this parameter is rather useless for this geocoder. :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.location.Location` or a list of them, if ``exactly_one=False``. &Search string must be 'word.word.word')addrr/key?%s.geocode: %sr0r)rrGeocoderQueryErrorlowerr%joinr'rr debugr,__name__r _parse_json_call_geocoderr+rr/r0rparamsurlcallbacks rgeocodezWhat3Words.geocodeXsBE"((8  JJL<<  hh(()F*;<= %t~~'>'>D4++E""3'"BBrc|djd}|r:d|ddz}|dk(rtj|tj|d}||}|r|S|gS)g Parse type, words, latitude, and longitude and language from a JSON response. statuscode Error returned by What3Words: %smessageicd|vr=|d}|d}|d|d}}|r|rt|}t|}t|||f|Stjd)' Parse record. geometrywordslatlngError parsing result.floatrrGeocoderParseErrorresourcerNpositionlatitude longitudes rparse_resourcez.What3Words._parse_json..parse_resourceso X% )#J/&.uox) $XH %i 0I)'zWhat3Words._parse_jsons{ "&&v. 89X;Ny;YYGs{77@@((1 1 F""), O: rct|j}|j||j|jd}dj|jt |f}t jd|jj|t|j|}|j|||S)a Return a `3 words` address by location point. Each point on the surface has a `3 words` address, so there's always a non-empty response. :param query: The coordinates for which you wish to obtain the 3 word address. :type query: :class:`geopy.point.Point`, list or tuple of ``(latitude, longitude)``, or string as ``"%(latitude)s, %(longitude)s"``. :param str lang: two character language code as supported by the API (https://docs.what3words.com/api/v2/#lang). :param bool exactly_one: Return one result or a list of results, if available. Due to the address scheme there is always exactly one result for each `3 words` address, so this parameter is rather useless for this geocoder. :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.location.Location` or a list of them, if ``exactly_one=False``. )coordsr/r4r5%s.reverse: %sr7r8 r:_coerce_point_to_stringr%r;r)rr r<r,r=r_parse_reverse_jsonr?r@s rreversezWhat3Words.reversesDzz|2259JJL<<  hh(()F*;<= %t~~'>'>D433M""3'"BBrc&|j||SzJ Parses a location from a single-result reverse API call. r>r+r^r0s rrfzWhat3Words._parse_reverse_json ;77rT r= __module__ __qualname____doc__r&r(rr$rDr>rgrf __classcell__r,s@rr r s^!L L %$( '1Rn$ /Cb%V$ .C`8rr cheZdZdZdZdZeededddfd Zded d Zdd Z d ded dZ ddZ xZ S)r zWhat3Words geocoder using the V3 API. Documentation at: https://developer.what3words.com/public-api/docs .. versionadded:: 2.2 z/v3/convert-to-coordinatesz/v3/convert-to-3waNrrct|d|||||||_|jd||j|_|jd||j |_y)a :param str api_key: Key provided by What3Words (https://accounts.what3words.com/register). :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`. :param str domain: base api domain .. versionadded:: 2.4 rrr!Nr"r*s rr$zWhat3WordsV3.__init__seH !#+   *.++vt?P?PQ*.++vt?P?PQrT)r0rcXt|stjd||jd}dj |j t |f}tjd|jj|t|j|}|j|||S)a Return a location point for a `3 words` query. If the `3 words` address doesn't exist, a :class:`geopy.exc.GeocoderQueryError` exception will be thrown. :param str query: The 3-word address you wish to geocode. :param bool exactly_one: Return one result or a list of results, if available. Due to the address scheme there is always exactly one result for each `3 words` address, so this parameter is rather useless for this geocoder. :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.location.Location` or a list of them, if ``exactly_one=False``. r2)rNr4r5r6r7r8)rrr9r%r;r'rr r<r,r=rr>r?)r+rr0rrArBrCs rrDzWhat3WordsV3.geocode$s:E"((8  <<  hh(()F*;<= %t~~'>'>D4++E""3'"BBrc|jd}|Jd|ddz}|jd}|dvrtj|tj|d}||}|r|S|gS)rFerrorrIrJrH) MissingKey InvalidKeycd|vr=|d}|d}|d|d}}|r|rt|}t|}t|||f|Stjd)rL coordinatesrNrOrPrQrRrUs rrZz0What3WordsV3._parse_json..parse_resourceaso ( )#M2&.uox) $XH %i 0I)'zWhat3WordsV3._parse_jsonPs  g&  89W;Mi;XXGyy(H7777@@((1 1 F""), O: rr-r.ct|j}|j||j|jd}dj|jt |f}t jd|jj|t|j|}|j|||S)a Return a `3 words` address by location point. Each point on the surface has a `3 words` address, so there's always a non-empty response. :param query: The coordinates for which you wish to obtain the 3 word address. :type query: :class:`geopy.point.Point`, list or tuple of ``(latitude, longitude)``, or string as ``"%(latitude)s, %(longitude)s"``. :param str lang: two character language code as supported by the API (https://developer.what3words.com/public-api/docs#available-languages). :param bool exactly_one: Return one result or a list of results, if available. Due to the address scheme there is always exactly one result for each `3 words` address, so this parameter is rather useless for this geocoder. :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.location.Location` or a list of them, if ``exactly_one=False``. )r|languager4r5rcr7r8rdr@s rrgzWhat3WordsV3.reversexsDzz| 77> <<  hh(()F*;<= %t~~'>'>D433M""3'"BBrc&|j||Srirjrks rrfz What3WordsV3._parse_reverse_jsonrlrrmrnrss@rr r s[0L'L %$( '/Rj$ *CX&X$ .C`8rr )re functoolsr urllib.parsergeopyrgeopy.geocoders.baserrgeopy.locationr geopy.utilr __all__compileUrrr r rrrs[ ";# (BJJ4bdd 0L8L8^E88E8r