o Fh@sddlZddlZddlmZddlmZddlmZddl m Z m Z ddl m Z mZmZddlmZddlmZd ZGd d d eZdS) N)partial) urlencode)AdapterHTTPError)GeocoderQueryErrorGeocoderQuotaExceeded)DEFAULT_SENTINEL NONE_RESULTGeocoder)Location)logger)GeocodiocseZdZdZhdZdZdZdZdeededddfdd Z dd ed d d Z d eddddZ dddZ ddZ ddZZS)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_factorydomainc s0tj||||||d||_|r||_dSdS)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__Q/var/www/html/loop/nvenv/lib/python3.10/site-packages/geopy/geocoders/geocodio.pyr's' zGeocodio.__init__T)limit exactly_onerc st|tjjrfdd|D}nd|i}j|d<|r"||d<|r(d|d<djjjf}d |t |f}t d j j|tj|d }j|||d S) 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``. cs i|] \}}|jvr||qSr)structured_query_params).0keyvalrrr |s  z$Geocodio.geocode..qrr! %s://%s%s?z%s.geocode: %sr"r) isinstance collectionsabcMappingitemsrrr geocode_pathjoinrr debugr__name__r _parse_json_call_geocoder) rqueryr!r"rparamsapiurlcallbackrr'r geocodeZs!  zGeocodio.geocode)r"rr!c Cs|||jd}|r d}|dur||d<d|j|j|jf}d|t|f}td|j j |t |j |d}|j |||d 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*Nr!r+r,z%s.reverse: %sr-r.)_coerce_point_to_stringrrr reverse_pathr5rr r6rr7rr8r9) rr:r"rr!r;r<r=r>rrr reverseszGeocodio.reversecs>|dg}|s dSdd|r|dSfdd|DS)z7Returns location, (latitude, longitude) from json feed.resultsNcSs2|d}|dd}|dd}t|||f|S)z4Get the location, lat, lng from a single json place.formatted_addresslocationlatlng)getr )placerElatitude longituderrr parse_places   z)Geocodio._parse_json..parse_placercsg|]}|qSrr)r$rIrLrr sz(Geocodio._parse_json..)rH)rpager"placesrrMr r8s  zGeocodio._parse_jsoncCst|tsdS|jdus|jdurdS|jdkr0||}d|vr+d|vr+tSt|||jdkrE||}d}||vrGt||dSdS)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_messagelowerrrr)rerror error_messagequota_exceeded_snippetrrr _geocoder_exception_handlers"         z$Geocodio._geocoder_exception_handlercCs8z t|jd}Wn tyd}Ynw|p|jS)zVTry to extract an error message from the 'error' property of a JSON response. rUN)jsonloadsrRrH ValueError)rrUrVrrr rSs   zGeocodio._get_error_message)T)r7 __module__ __qualname____doc__r#rr4rArrr?rBr8rXrS __classcell__rrrr r s2 7 = +r )collections.abcr0rY functoolsr urllib.parsergeopy.adaptersr geopy.excrrgeopy.geocoders.baserrr geopy.locationr geopy.utilr __all__r rrrr s