o FhS0@sddlZddlmZddlmZddlmZddlmZmZm Z ddl m Z m Z m Z ddlmZddlmZd Zd ZGd d d e ZdS) N)partial)time) urlencode)ConfigurationErrorGeocoderAuthenticationFailureGeocoderServiceError)DEFAULT_SENTINELGeocoder _synchronized)Location)logger)ArcGISic seZdZdZdZdZdZdZ  ddddeededdd d fd d Z d eddddZ ddZ d eddddZ ddZ edddZeddZZS)r zGeocoder 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 stj||||| | d|s|s|r%|r|r|std|jdkr%td||_||_||_| d|_d|j|j|j f|_ |d|_ | d|_ d|j|j |j f|_d|j|j |jf|_d|_d|_dS) 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 %s://%s%srN)super__init__rrusernamepasswordrstripr auth_pathauth_apirr geocode_pathapi reverse_path reverse_apitoken token_expiry) selfrrrrrrrrrrrr __class__O/var/www/html/loop/nvenv/lib/python3.10/site-packages/geopy/geocoders/arcgis.pyr!s>>       zArcGIS.__init__T) exactly_oner out_fieldscCs|dd}|r d|d<|dur t|tr||d<nd||d<d|jt|f}td |jj|t |j |d }|j |||d 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 maxLocationsN outFields,?z%s.geocode: %sr-r) isinstancestrjoinr#rr debugr*__name__r_parse_geocode_authenticated_call_geocoder)r(queryr-rr.paramsurlcallbackr+r+r,geocodes   zArcGIS.geocodecCstd|vr tt|dt|dsdSg}|dD]}|d}|t|d|d|df|q|r8|dS|S)Nerror candidateslocationaddressyxr)rr:lenappendr )r(responser-geocodedresourcegeometryr+r+r,r>s  zArcGIS._parse_geocode)r-rdistancec Csp||d}t}|d|d}|dur||d<d|jt|f}td|jj|t |j |d} |j || |d 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)sr/)rGr1outSRNrQr6z%s.reverse: %sr7r8) _coerce_point_to_string DEFAULT_WKIDr;r%rr r<r*r=r_parse_reverser?) r(r@r-rrQrGwkidrArBrCr+r+r,reverses  zArcGIS.reversec Cst|sdSd|vr5|dddkr-zd|dddvr WdSWn ttfy,Ynwtt|d|ddrCd |d}n|dd }t||d d |d d f|d}|r_|S|gS)NrEcodeizUnable to finddetailsrrHAddressz=%(Address)s, %(City)s, %(Region)s %(Postal)s, %(CountryCode)s LongLabelrGrIrJ)rKKeyError IndexErrorrr:getr )r(rMr-rHrGr+r+r,rUs4 zArcGIS._parse_reverser8cs~js jdSfdd}fddfddjdus3ttjkr<j|jdS|S) Nr8cs>dtdjif}dji}j|tjd|dS)N&r&Referer) from_tokenrheaders)r;rr&r_call_geocoderrcall_urlrc)maybe_reauthenticate_callbackr(rrBr+r,query_callback s  z;ArcGIS._authenticated_call_geocoder..query_callbackcs2d|vr|ddjkrj|dS|S)NrErXrra)_TOKEN_EXPIRED_refresh_authentication_token)rMra)parse_callbackquery_retry_callbackr(rr+r,rgs zJArcGIS._authenticated_call_geocoder..maybe_reauthenticate_callbackcs4dtdjif}dji}j||dS)Nr_r&r`rb)r;rr&rrdre)rlr(rrBr+r,rms  zAArcGIS._authenticated_call_geocoder..query_retry_callbackri)rrdr&intrr'rk)r(rBrlrrhr+)rgrlrmr(rrBr,r?s z#ArcGIS._authenticated_call_geocodercsn|jkrSjjjjdd}djt|ft dj j fdd}j ||dS)Nr/)rrr expirationr1r6z$%s._refresh_authentication_token: %scs@d|vrtdt|f|d_ttj_S)Nr&z@Missing token in auth request.Request URL: %s; response JSON: %s)rr/dumpsr&rnrrr')rMcallback_successr(rBr+r,cb>s  z0ArcGIS._refresh_authentication_token..cbr8) r&rrrrr;r!rr r<r*r=rd)r(rrrratoken_request_argumentsrsr+rqr,rk+s  z$ArcGIS._refresh_authentication_token)NN)r= __module__ __qualname____doc__rjr r"r$rrrDr>rWrUr?r rk __classcell__r+r+r)r,r s@g ' #! &r )r/ functoolsrr urllib.parser geopy.excrrrgeopy.geocoders.baserr r geopy.locationr geopy.utilr __all__rTr r+r+r+r,s