g@@ddlZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z mZmZmZmZddlmZmZddlmZdd lmZmZdd lmZd ZGd d eZy)N)timegm)datetime)partial) urlencode)ConfigurationErrorGeocoderQueryErrorGeocoderQuotaExceededGeocoderServiceErrorGeocoderUnavailable)DEFAULT_SENTINELGeocoder)Location)ensure_pytz_is_installedfrom_timezone_name)logger)GoogleV3c eZdZdZdZdZ dddddeededdd fd Zd Zd Z dd edddddd d dZ d edd ddZ deddZ dZ dZddZdZxZS)rzGeocoder using the Google Maps v3 API. Documentation at: https://developers.google.com/maps/documentation/geocoding/ Pricing details: https://developers.google.com/maps/documentation/geocoding/usage-and-billing z/maps/api/geocode/jsonz/maps/api/timezone/jsonNzmaps.googleapis.com) domainscheme client_id secret_keytimeoutproxies user_agent ssl_contextadapter_factorychannelc t |||||| | |r |s td|r |s tdt|xr||_||_||_|js |s td||_|jd|_ | |_ |jd|j|j|_ |jd|j|j|_y)ag :param str api_key: The API key required by Google to perform geocoding requests, mandatory (unless premier is used, then both ``client_id`` and ``secret_key`` must be specified instead). API keys are managed through the Google APIs console (https://code.google.com/apis/console). Make sure to have both ``Geocoding API`` and ``Time Zone API`` services enabled for this API key. .. versionchanged:: 2.1 Previously a warning has been emitted when neither ``api_key`` nor premier were specified. Now a :class:`geopy.exc.ConfigurationError` is raised. :param str domain: Should be the localized Google Maps domain to connect to. The default is 'maps.googleapis.com', but if you're geocoding address in the UK (for example), you may want to set it to 'maps.google.co.uk' to properly bias results. :param str scheme: See :attr:`geopy.geocoders.options.default_scheme`. :param str client_id: If using premier, the account client id. :param str secret_key: If using premier, the account secret key. :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 :param str channel: If using premier, the channel identifier. )rrrrrrz'Must provide secret_key with client_id.z'Must provide client_id with secret_key.zSince July 2018 Google requires each request to have an API key. Pass a valid `api_key` to GoogleV3 geocoder to fix this error. See https://developers.google.com/maps/documentation/geocoding/usage-and-billing/://N)super__init__rboolpremierrrapi_keystriprrrapi_pathapi timezone_pathtz_api) selfr&rrrrrrrrrr __class__s V/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/google.pyr#zGoogleV3.__init__&s~ !#+   Z$%NO O i$%NO OI4*5 "$||G$c   ll3'  "&++t{{DMMJ%)[[$++t?Q?QR c|j|d<|jr|j|d<dj|jt |f}t j tj|j|jdtj}tj|jjd}|j d|j"|d|S)z Returns a Premier account signed url. Docs on signature: https://developers.google.com/maps/documentation/business/webservices/auth#digital_signatures clientr?zutf-8r!z &signature=)rrjoinr(rhmacnewbase64urlsafe_b64decoderencodehashlibsha1urlsafe_b64encodedigestdecoderr)r,paramspath signatures r._get_signed_urlzGoogleV3._get_signed_urls  >>x << $ F9 xx &(9:;HH  $ $T__ 5 KK LL ,,     &/  KKdI  r/c0g}t|tjjr|j }nHt|tjj rt|t tfs|}n tddjd|DS)Nz7`components` parameter must be of type `dict` or `list`|c3>K|]}dj|yw):N)r3).0items r. z4GoogleV3._format_components_param..s '6tCHHTNs) isinstance collectionsabcMappingitemsSequencestrbytes ValueErrorr3)r, componentscomponent_itemss r._format_components_paramz!GoogleV3._format_components_params j+//"9"9 :(..0O z;??#;#; <zC<8(OIK Kxx '6   r/TF) exactly_onerboundsregionrRplace_idlanguagesensorcxdt| ji} |r|s|r td||| d<||| d<|| |s td|jr|j| d<|r|j |d| d<|r|| d <|r|j || d <|r|| d <|j r|j| } n&d j|jt| 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. Optional, if ``components`` param is set:: >>> g.geocode(components={"city": "Paris", "country": "FR"}) Location(France, (46.227638, 2.213749, 0.0)) :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. :type bounds: list or tuple of 2 items of :class:`geopy.point.Point` or ``(latitude, longitude)`` or ``"%(latitude)s, %(longitude)s"``. :param bounds: The bounding box of the viewport within which to bias geocode results more prominently. Example: ``[Point(22, 180), Point(-22, -180)]``. :param str region: The region code, specified as a ccTLD ("top-level domain") two-character value. :type components: dict or list :param components: Restricts to an area. Can use any combination of: `route`, `locality`, `administrative_area`, `postal_code`, `country`. Pass a list of tuples if you want to specify multiple components of the same type, e.g.: >>> [('administrative_area', 'VA'), ('administrative_area', 'Arlington')] :param str place_id: Retrieve a Location using a Place ID. Cannot be not used with ``query`` or ``bounds`` parameters. >>> g.geocode(place_id='ChIJOcfP0Iq2j4ARDrXUa7ZWs34') :param str language: The language in which to return results. :param bool sensor: Whether the geocoding request comes from a device with a location sensor. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. rZzNOnly one of the `query` or `place id` or `bounds` parameters must be entered.rXaddressz9Either `query` or `components` or `place_id` must be set.keyz#%(lat1)s,%(lon1)s|%(lat2)s,%(lon2)srVrWrRrYr2z%s.geocode: %srUr)rOlowerrQr&_format_bounding_boxrTr%rAr3r)rrdebugr-__name__r _parse_json_call_geocoder) r,queryrUrrVrWrRrXrYrZr>urlcallbacks r.geocodezGoogleV3.geocodesW~ c&k'')  5/0 0  !)F:    %F9  =X-j,- - << LLF5M #88= ?F8  %F8  #'#@#@#LF< !)F:  <<&&v.C((DHHi&789C %t~~'>'>D4++E""3'"BBr/)rUrrYrZc|j|t|jd}|r||d<|jr|j|d<|js'dj |j t|f}n|j|}tjd|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 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 str language: The language in which to return results. :param bool sensor: Whether the geocoding request comes from a device with a location sensor. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. )latlngrZrYr]r2z%s.reverse: %sr^r_)_coerce_point_to_stringrOr`r&r%r3r)rrArrbr-rcrrdre) r,rfrUrrYrZr>rgrhs r.reversezGoogleV3.reversesF2259&k'')  !)F:  << LLF5M||((DHHi&789C&&v.C %t~~'>'>D4++E""3'"BBr/)at_timercxt|j|}|j|}||d}|jr|j|d<dj |j t |f}tjd|jj||j||j|S)al Find the timezone a point in `query` was in for a specified `at_time`. `None` will be returned for points without an assigned Olson timezone id (e.g. for Antarctica). :param query: The coordinates for which you want a timezone. :type query: :class:`geopy.point.Point`, list or tuple of (latitude, longitude), or string as "%(latitude)s, %(longitude)s" :param at_time: The time at which you want the timezone of this location. This is optional, and defaults to the time that the function is called in UTC. Timezone-aware datetimes are correctly handled and naive datetimes are silently treated as UTC. :type at_time: :class:`datetime.datetime` or None :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`` or :class:`geopy.timezone.Timezone`. )location timestampr]r2z%s.reverse_timezone: %sr_) rrl_normalize_timezone_at_timer&r3r+rrrbr-rcre_parse_json_timezone)r,rfrnrrprqr>rgs r.reverse_timezonezGoogleV3.reverse_timezoneGs0 !"//644W= !"  << LLF5Mhh Yv%678 .0G0GM""3(A(A7"SSr/cf|j||jd}|yt||S)N timeZoneId)raw) _check_statusgetr)r,response timezone_ids r.rszGoogleV3._parse_json_timezoneps6 8$ll<0   !+8<.parse_placesMyy!45HZ(4U;Hj)*5e  ^ #  _5 = ='**  ' '$]%O6OP P ( ($E!E  &%m&E~F F'}'GH Hr/)N)T)rc __module__ __qualname____doc__r(r*r r#rArTrirmrtrsrrrdrx __classcell__)r-s@r.rrs(H-M]S)$$( ]S~ . (cC$cCR$2Ch26?O'TR = <$Ir/r)r6collections.abcrJr9r4calendarrr functoolsr urllib.parser geopy.excrrr r r geopy.geocoders.baser r geopy.locationrgeopy.timezonerr geopy.utilr__all__rr/r.rsJ  "<#G aIxaIr/