a }c7@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|sdSdSdS)z) Check query validity with regex FTN)_MULTIPLE_WORD_REmatch)queryrV/var/www/html/django/DPS/env/lib/python3.9/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_factorycsNtjd|||||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_apiselfrrrrrrdomain __class__rrr(s! zWhat3Words.__init__enTlang exactly_onercCsht|std|||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)rrGeocoderQueryErrorlowerrjoinr!rrdebugr(__name__r _parse_json_call_geocoderr%r r+r,rparamsurlcallbackrrrgeocodeWs!zWhat3Words.geocodecCs`|dd}|r>d|dd}|dkr4t|t|dd}||}|rV|S|gSdS) g Parse type, words, latitude, and longitude and language from a JSON response. statuscode Error returned by What3Words: %smessageicSs`d|vrR|d}|d}|d|d}}|rB|rBt|}t|}t|||f|StddS)' Parse record. ZgeometrywordslatlngError parsing result.NfloatrrZGeocoderParseErrorresourcerFpositionZlatitudeZ longituderrrparse_resourcesz.What3Words._parse_json..parse_resourceNgetrZGeocoderAuthenticationFailurer4)r% resourcesr,rBexc_msgrOlocationrrrr9s  zWhat3Words._parse_jsoncCsd|}||||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``. )Zcoordsr+r/r0%s.reverse: %sr2r3 r5Z_coerce_point_to_stringrr6r#rrr7r(r8r_parse_reverse_jsonr:r;rrrreverses"zWhat3Words.reversecCs |||SzJ Parses a location from a single-result reverse API call. r9r%rRr,rrrrWszWhat3Words._parse_reverse_json)T)T r8 __module__ __qualname____doc__r r"rrr?r9rXrW __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-3waNrcsNtjd|||||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`. rrrrNrr$r'rrrs zWhat3WordsV3.__init__T)r,rcCsbt|std||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-)rFr/r0r1r2r3)rrr4rr6r!rrr7r(r8rr9r:)r%r r,rr<r=r>rrrr?szWhat3WordsV3.geocodecCsj|d}|durHd|dd}|d}|dvr>t|t|dd}||}|r`|S|gSdS) r@errorNrCrDrB)Z MissingKeyZ InvalidKeycSs`d|vrR|d}|d}|d|d}}|rB|rBt|}t|}t|||f|StddS)rE coordinatesrFrGrHrINrJrLrrrrO\sz0What3WordsV3._parse_json..parse_resourcerP)r%rRr,rarSZexc_coderOrTrrrr9Ks    zWhat3WordsV3._parse_jsonr)r*cCsd|}||||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://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``. )rblanguager/r0rUr2r3rVr;rrrrXss"zWhat3WordsV3.reversecCs |||SrYrZr[rrrrWsz What3WordsV3._parse_reverse_json)T)Tr\rrr'rr s$1 , , 0r )re functoolsr urllib.parserZgeopyrZgeopy.geocoders.baserrZgeopy.locationrZ geopy.utilr__all__compileUr rr r rrrrs      L