gnddlmZddlmZddlmZddlmZmZm Z ddl m Z ddl m Z dZGdd e Zy ) )partial) urlencode)GeocoderServiceError)DEFAULT_SENTINELERROR_CODE_MAPGeocoder)Location)logger)OpenCagecleZdZdZdZddeededdfd Zdddddedd Zdded d Zdd Z d Z xZ S)r aEGeocoder using the OpenCageData API. Documentation at: https://opencagedata.com/api .. versionchanged:: 2.2 Improved error handling by using the default errors map (e.g. to raise :class:`.exc.GeocoderQuotaExceeded` instead of :class:`.exc.GeocoderQueryError` for HTTP 402 error) z/geocode/v1/jsonzapi.opencagedata.comN)domainschemetimeoutproxies user_agent ssl_contextadapter_factoryct |||||||||_|jd|_|j d|j|j |_y)a :param str api_key: The API key required by OpenCageData to perform geocoding requests. You can get your key here: https://opencagedata.com/ :param str domain: Currently it is ``'api.opencagedata.com'``, can be changed for testing purposes. :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`. .. versionadded:: 2.0 )rrrrrr/z://N)super__init__api_keystripr rapi_pathapi) selfrr rrrrrr __class__s X/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/opencage.pyrzOpenCage.__init__s]T !#+   ll3' "&++t{{DMMJT)boundscountrylanguage annotations exactly_onerc|j|d}|sd|d<|r|j|d|d<|r||d<|sg}t|tr|g}|rdj ||d<d j |j t |f} tjd |jj| t|j| } |j| | | S) a Return a location point by address. :param str query: The address or query you wish to geocode. :type bounds: list or tuple of 2 items of :class:`geopy.point.Point` or ``(latitude, longitude)`` or ``"%(latitude)s, %(longitude)s"``. :param bounds: Provides the geocoder with a hint to the region that the query resides in. This value will help the geocoder but will not restrict the possible results to the supplied region. The bounds parameter should be specified as 2 coordinate points -- corners of a bounding box. Example: ``[Point(22, 180), Point(-22, -180)]``. :param country: Restricts the results to the specified country or countries. The country code is a 2 character code as defined by the ISO 3166-1 Alpha 2 standard (e.g. ``fr``). Might be a Python list of strings. :type country: str or list :param str language: an IETF format language code (such as `es` for Spanish or pt-BR for Brazilian Portuguese); if this is omitted a code of `en` (English) will be assumed by the remote service. :param bool annotations: Enable `annotations `_ data, which can be accessed via :attr:`.Location.raw`. Set to False if you don't need it to gain a little performance win. .. versionadded:: 2.2 :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``. keyqno_annotationsz#%(lon1)s,%(lat1)s,%(lon2)s,%(lat2)sr r", countrycode?z%s.geocode: %sr$r)r_format_bounding_box isinstancestrjoinrrr debugr__name__r _parse_json_call_geocoder) rqueryr r!r"r#r$rparamsurlcallbacks rgeocodezOpenCage.geocodeQsr<< '(F# $ #88= ?F8  !)F: G gs #iG $'HHW$5F= !hh)F"345 %t~~'>'>D4++E""3'"BBr)r"r$rcD|j|j|d}|r||d<dj|jt |f}t j d|jj|t|j|}|j|||S)a Return an address by location point. :param query: The coordinates for which you wish to obtain the closest human-readable addresses. :type query: :class:`geopy.point.Point`, list or tuple of ``(latitude, longitude)``, or string as ``"%(latitude)s, %(longitude)s"``. :param str language: The language in which to return results. :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``. r&r"r-z%s.reverse: %sr.r/) r_coerce_point_to_stringr3rrr r4rr5rr6r7)rr8r"r$rr9r:r;s rreversezOpenCage.reverses@<<--e4  !)F: hh)F"345 %t~~'>'>D4++E""3'"BBrc|jdg}t|s!|j|jdyd}|r ||dS|Dcgc] }|| c}Scc}w)z7Returns location, (latitude, longitude) from json feed.resultsstatusNcb|jd}|dd}|dd}t|||f|S)z4Get the location, lat, lng from a single json place. formattedgeometrylatlng)getr )placelocationlatitude longitudes r parse_placez)OpenCage._parse_json..parse_placesByy-HZ(/Hj)%0IHx&;UC Crr)rHlen _check_status)rpager$placesrMrIs rr6zOpenCage._parse_jsonsl)R(6{   txx1 2 D vay) )4:;F5K&F; ;;sA%cf|d}|d}|dk(rytj|t}||)Ncodemessage)rrHr)rrB status_coderTexc_clss rrOzOpenCage._check_statuss>Vn # #   $$[2FGgr)T) r5 __module__ __qualname____doc__rrrr<r?r6rO __classcell__)rs@rr r se "H *$$( 5Kv$OCj$ )CV<(rr N) functoolsr urllib.parser geopy.excrgeopy.geocoders.baserrrgeopy.locationr geopy.utilr __all__r rrrds-"*KK# \x\r