gddlZddlZddlmZddlmZddlmZddl m Z m Z ddl m Z mZmZddlmZddlmZd ZGd d eZy) N)partial) urlencode)AdapterHTTPError)GeocoderQueryErrorGeocoderQuotaExceeded)DEFAULT_SENTINEL NONE_RESULTGeocoder)Location)logger)Geocodioc|eZdZdZhdZdZdZdZdeededddfd Z dd ed d Z d edd d Z ddZ dZ dZxZS)r zGeocoder using the Geocod.io API. Documentation at: https://www.geocod.io/docs/ Pricing details: https://www.geocod.io/pricing/ .. versionadded:: 2.2 >citystatestreetcountry postal_codez api.geocod.ioz /v1.6/geocodez /v1.6/reverseN)schemetimeoutproxies user_agent ssl_contextadapter_factorydomaincRt |||||||||_|r||_yy)aG :param str api_key: A valid Geocod.io API key. (https://dash.geocod.io/apikey/create) :param str scheme: See :attr:`geopy.geocoders.options.default_scheme`. :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 )rrrrrrN)super__init__api_keyr) selfrrrrrrrr __class__s X/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/geocodio.pyrzGeocodio.__init__'sBN !#+    DK T)limit exactly_onerc.t|tjjr2|j Dcic]\}}||j vr||}}}nd|i}|j |d<|r||d<|rd|d<|jd|j|j}dj|t|f} tjd|jj| t!|j"|} |j%| | | Scc}}w) a Return a location point by address. :param query: The address, query or a structured query you wish to geocode. For a structured query, provide a dictionary whose keys are one of: `street`, `city`, `state`, `postal_code` or `country`. :type query: dict or str :param int limit: The maximum number of matches to return. This will be reset to 1 if ``exactly_one`` is ``True``. :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``. qrr#://?z%s.geocode: %sr$r) isinstance collectionsabcMappingitemsstructured_query_paramsrrr geocode_pathjoinrr debugr __name__r _parse_json_call_geocoder) rqueryr#r$rkeyvalparamsapiurlcallbacks r!geocodezGeocodio.geocodeZs B e[__44 5;;=!C$666S  5\F LLy #F7O F7O![[$++t7H7HIhhYv./0 %t~~'>'>D4++E""3'"BB+sD)r$rr#c|j||jd}|rd}|||d<|jd|j|j}dj |t |f}tjd|jj|t|j|}|j|||S) a5Return an address by location point. :param str query: The coordinates for which you wish to obtain the closest human-readable addresses :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 int limit: The maximum number of matches to return. This will be reset to 1 if ``exactly_one`` is ``True``. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. )r&rr'r#r(r)z%s.reverse: %sr*r+)_coerce_point_to_stringrrr reverse_pathr3rr r4r r5rr6r7) rr8r$rr#r;r<r=r>s r!reversezGeocodio.reverses8--e4||  E  #F7O![[$++t7H7HIhhYv./0 %t~~'>'>D4++E""3'"BBr"c|jdg}|syd}|r ||dS|Dcgc] }|| c}Scc}w)z7Returns location, (latitude, longitude) from json feed.resultsNcb|jd}|dd}|dd}t|||f|S)z4Get the location, lat, lng from a single json place.formatted_addresslocationlatlng)getr )placerHlatitude longitudes r! parse_placez)Geocodio._parse_json..parse_placesCyy!45HZ(/Hj)%0IHx&;UC Cr"r)rK)rpager$placesrOrLs r!r6zGeocodio._parse_jsonsQ)R( D vay) )4:;F5K&F; ;;s<cjt|tsy|j |jy|jdk(rG|j |}d|j vrd|j vrt St|||jdk(r$|j |}d}||vr t||yy)aCustom exception handling for invalid queries and exceeded quotas. Geocod.io returns a ``422`` status code for invalid queries, which is not mapped in :const:`~geopy.geocoders.base.ERROR_CODE_MAP`. The service also returns a ``403`` status code for exceeded quotas instead of the ``429`` code mapped in :const:`~geopy.geocoders.base.ERROR_CODE_MAP` Nizcould not geocode addresszpostal code or city requirediz>You can't make this request as it is above your daily maximum.) r,r status_codetext_get_error_messagelowerr rr)rerror error_messagequota_exceeded_snippets r!_geocoder_exception_handlerz$Geocodio._geocoder_exception_handlers%!12     $ (:     # 33E:M+}/B/B/DD2m6I6I6KK""$]3 >    # 33E:M&A "%6+M:E7 $r"c tj|jjd}|xs |jS#t$rd}YwxYw)zVTry to extract an error message from the 'error' property of a JSON response. rWN)jsonloadsrTrK ValueError)rrWrXs r!rUzGeocodio._get_error_messagesK ! JJuzz266w?M* * ! M !s.A A A)T)r5 __module__ __qualname____doc__r1rr2rBrrr?rCr6rZrU __classcell__)r s@r!r r sr F"L"L   $1!n 7Cz  )CV<&F6+r"r )collections.abcr-r\ functoolsr urllib.parsergeopy.adaptersr geopy.excrrgeopy.geocoders.baserr r geopy.locationr geopy.utilr __all__r r"r!rms6 "+?HH# d+xd+r"