gS0ddlZddlmZddlmZddlmZddlmZmZm Z ddl m Z m Z m Z ddlmZddlmZd Zd ZGd d e Zy) N)partial)time) urlencode)ConfigurationErrorGeocoderAuthenticationFailureGeocoderServiceError)DEFAULT_SENTINELGeocoder _synchronized)Location)logger)ArcGISic eZdZdZdZdZdZdZ ddddeededdd d fd Z d edd dZ dZ d edddZ dZ eddZedZxZS)rzGeocoder using the ERSI ArcGIS API. Documentation at: https://developers.arcgis.com/rest/geocode/api-reference/overview-world-geocoding-service.htm iz/sharing/generateTokenz?/arcgis/rest/services/World/GeocodeServer/findAddressCandidatesz8/arcgis/rest/services/World/GeocodeServer/reverseGeocodeN<zwww.arcgis.comzgeocode.arcgis.com) referertoken_lifetimeschemetimeoutproxies user_agent ssl_contextadapter_factory auth_domaindomainc Lt |||||| | |s|s|r+|r|r|s td|jdk7r td||_||_||_| jd|_|jd|j|j|_ |dz|_ | jd|_ |jd|j|j|_|jd|j|j|_d|_d|_y) a :param str username: ArcGIS username. Required if authenticated mode is desired. :param str password: ArcGIS password. Required if authenticated mode is desired. :param str referer: Required if authenticated mode is desired. `Referer` HTTP header to send with each request, e.g., ``'http://www.example.com'``. This is tied to an issued token, so fielding queries for multiple referrers should be handled by having multiple ArcGIS geocoder instances. :param int token_lifetime: Desired lifetime, in minutes, of an ArcGIS-issued token. :param str scheme: See :attr:`geopy.geocoders.options.default_scheme`. If authenticated mode is in use, it must be ``'https'``. :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 auth_domain: Domain where the target ArcGIS auth service is hosted. Used only in authenticated mode (i.e. username, password and referer are set). :param str domain: Domain where the target ArcGIS service is hosted. )rrrrrrz;Authenticated mode requires username, password, and refererhttpsz-Authenticated mode requires scheme of 'https'/z://rN)super__init__rrusernamepasswordrstripr auth_pathauth_apirr geocode_pathapi reverse_path reverse_apitoken token_expiry)selfr r!rrrrrrrrrr __class__s V/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/geocoders/arcgis.pyrzArcGIS.__init__!s$| !#+   x7g(-{{g%(C!    &,,S1;;(8(8$.. I -r1ll3' ;; T5F5F G  ;; T5F5F G    T) exactly_oner out_fieldscj|dd}|rd|d<|*t|tr||d<ndj||d<dj|jt |f}t j d|jj|t|j| }|j||| S) am Return a location point by address. :param str query: The address or query you wish to geocode. :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 out_fields: A list of output fields to be returned in the attributes field of the raw data. This can be either a python list/tuple of fields or a comma-separated string. See https://developers.arcgis.com/rest/geocode/api-reference/geocoding-service-output.htm for a list of supported output fields. If you want to return all supported output fields, set ``out_fields="*"``. :type out_fields: str or iterable :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. json) singleLinef maxLocations outFields,?z%s.geocode: %sr/r) isinstancestrjoinr&rr debugr,__name__r_parse_geocode_authenticated_call_geocoder)r+queryr/rr0paramsurlcallbacks r-geocodezArcGIS.geocodes4!&F3 %&F> "  !*c*&0{#&)hhz&:{#hh)F"345 %t~~'>'>D4..KH00h0PPr.c d|vrtt|dt|dsyg}|dD].}|d}|jt |d|d|df|0|r|dS|S)Nerror candidateslocationaddressyxr)rr=lenappendr )r+responser/geocodedresourcegeometrys r-rAzArcGIS._parse_geocodes h &s8G+<'=> >8L)* .H +H OOY'(3-#)G / A; r.)r/rdistancecD|j|d}t}|d|d}|||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 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 distance: Distance from the query location, in meters, within which to search. ArcGIS has a default of 100 meters, if not specified. :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if ``exactly_one=False``. z%(lon)s,%(lat)sr2)rKr4outSRrUr9z%s.reverse: %sr:r;) _coerce_point_to_string DEFAULT_WKIDr>r(rr r?r,r@r_parse_reverserB) r+rCr/rrUrKwkidrDrErFs r-reversezArcGIS.reverses2//7HI&VdC  !)F: hh(()F*;<= %t~~'>'>D4..KH00h0PPr.cDt|syd|vr2|dddk(r d|dddvry tt |d|dj dr d |dz}n|dd }t ||d d |d d f|d}|r|S|gS#ttf$rYrwxYw)NrIcodeizUnable to finddetailsrrLAddressz=%(Address)s, %(City)s, %(Region)s %(Postal)s, %(CountryCode)s LongLabelrKrMrN)rOKeyError IndexErrorrr=getr )r+rQr/rLrKs r-rZzArcGIS._parse_reverses8} h  (C/'8G+ > I  " "9 -#%-i%89  y)+6G  j !# &(rr)r_call_geocoderr)call_urlrkmaybe_reauthenticate_callbackr+rrEs r-query_callbackz;ArcGIS._authenticated_call_geocoder..query_callback sbxxi$**0E&F GHH $,,/G&&5$**M ' r.cnd|vr)|ddjk(rj|S|S)NrIr^rri)_TOKEN_EXPIRED_refresh_authentication_token)rQriparse_callbackquery_retry_callbackr+rs r-rnzJArcGIS._authenticated_call_geocoder..maybe_reauthenticate_callbacksO("G$V,0C0CC==,g*>"(+ +r.cdjtdjif}dji}j ||S)Nrgr)rhrj)r>rr)rrl)rmrkrtr+rrEs r-ruzAArcGIS._authenticated_call_geocoder..query_retry_callbacksSxxi$**0E&F GHH $,,/G&&.'7' r.rq)r rlr)intrr*rs)r+rErtrrornrus```` @@r-rBz#ArcGIS._authenticated_call_geocoders}}&&sNG&L L  ,  :: TVt/@/@!@55DJJ6 "# #r.cl|jk7rSjjjjdd}dj j t|ftjdjjfd}j||S)Nr2)r r!r expirationr4r9z$%s._refresh_authentication_token: %scd|vr$tddtj||d_t t j z_S)Nr)z+Missing token in auth request.Request URL: z; response JSON: )rr2dumpsr)rwrrr*)rQcallback_successr+rEs r-cbz0ArcGIS._refresh_authentication_token..cb>s\h&3r$rr r?r,r@rl)r+r|rritoken_request_argumentsr}rEs`` @r-rsz$ArcGIS._refresh_authentication_token+s  ##% %  ||-- # hh y1H'IJK 2 NN # #S  &""3G"<rsB " KJ#  t=Xt=r.