o 4c7@sddlZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z dZed ejZd d ZGd d d e ZGddde ZdS)N)partial) urlencode)exc)DEFAULT_SENTINELGeocoder)Location)logger) What3Words What3WordsV3z-[^\W\d\_]+\.{1,1}[^\W\d\_]+\.{1,1}[^\W\d\_]+$cCst|sdSdS)z) Check query validity with regex FT)_MULTIPLE_WORD_REmatch)queryrP/var/www/html/gps/gps/lib/python3.10/site-packages/geopy/geocoders/what3words.py _check_querys rcsneZdZdZdZdZeededdfdd Zdd ed d d Zdd dZ dd ed ddZ dddZ Z 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/reverseNtimeoutproxies user_agent ssl_contextadapter_factorycNtjd|||||d||_d}d|j||jf|_d|j||jf|_dS)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 httpsschemerrrrrapi.what3words.com %s://%s%sNsuper__init__api_keyr geocode_path geocode_api reverse_path reverse_apiselfr rrrrrdomain __class__rrr(s! zWhat3Words.__init__enTlang exactly_onercCsht|s td|||jd}d|jt|f}t d|j j |t |j |d}|j|||dS)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: %sr-r)rrGeocoderQueryErrorlowerr joinr"rrdebugr)__name__r _parse_json_call_geocoderr&r r,r-rparamsurlcallbackrrrgeocodeWs!zWhat3Words.geocodecCs\|dd}|rd|dd}|dkrt|t|dd}||}|r+|S|gS)g Parse type, words, latitude, and longitude and language from a JSON response. statuscode Error returned by What3Words: %smessageicS\d|vr)|d}|d}|d|d}}|r!|r!t|}t|}t|||f|Std)' Parse record. geometrywordslatlngError parsing result.floatrrGeocoderParseErrorresourcerIpositionlatitude longituderrrparse_resource z.What3Words._parse_json..parse_resourcegetrGeocoderAuthenticationFailurer5)r& resourcesr-rCexc_msgrUlocationrrrr:s  zWhat3Words._parse_jsoncCd|}||||jd}d|jt|f}td|jj |t |j |d}|j |||dS)a Return a `3 words` address by location point. Each point on 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,r0r1%s.reverse: %sr3r4 r6_coerce_point_to_stringr r7r$rrr8r)r9r_parse_reverse_jsonr;r<rrrreverse"zWhat3Words.reversecC |||SzJ Parses a location from a single-result reverse API call. r:r&rZr-rrrrb zWhat3Words._parse_reverse_jsonT r9 __module__ __qualname____doc__r!r#rrr@r:rcrb __classcell__rrr(rr s( 3 1+ 0r csleZdZdZdZdZeededdfdd Zded d d Zdd d Z ddedddZ dddZ Z 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-3waNrcr)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`. rrrrNrr%r(rrrs zWhat3WordsV3.__init__T)r-rcCsbt|s td||jd}d|jt|f}td|j j |t |j |d}|j |||dS)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``. r.)rIr0r1r2r3r4)rrr5r r7r"rrr8r)r9rr:r;)r&r r-rr=r>r?rrrr@szWhat3WordsV3.geocodecCsf|d}|dur$d|dd}|d}|dvrt|t|dd}||}|r0|S|gS) rAerrorNrDrErC) MissingKey InvalidKeycSrF)rG coordinatesrIrJrKrLrMrPrrrrU\rVz0What3WordsV3._parse_json..parse_resourcerW)r&rZr-rpr[exc_coderUr\rrrr:Ks    zWhat3WordsV3._parse_jsonr*r+cCr])a Return a `3 words` address by location point. Each point on 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``. )rslanguager0r1r_r3r4r`r<rrrrcsrdzWhat3WordsV3.reversecCrerfrgrhrrrrbriz What3WordsV3._parse_reverse_jsonrjrkrrr(rr s&1 ,, 0r )re functoolsr urllib.parsergeopyrgeopy.geocoders.baserrgeopy.locationr geopy.utilr__all__compileUr rr r rrrrs      L