a }cS0@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 seZdZdZdZdZdZdZddddeededdd 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$|rJ|r0|r0|s8td|jdkrJtd||_||_||_| 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__R/var/www/html/django/DPS/env/lib/python3.9/site-packages/geopy/geocoders/arcgis.pyr!s>>      zArcGIS.__init__T) exactly_oner out_fieldscCs|dd}|rd|d<|dur@t|tr2||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)Z singleLinefZ maxLocationsNZ 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|vrtt|dt|ds(dSg}|dD].}|d}|t|d|d|df|q4|rp|dS|S)Nerror candidateslocationaddressyxr)rr7lenappendr )r(responser-ZgeocodedresourceZgeometryr+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/)rDr0ZoutSRNrLr3z%s.reverse: %sr4r5) Z_coerce_point_to_string DEFAULT_WKIDr8r%rr r9r*r:r_parse_reverser<) r(r=r-rrLrDZwkidr>r?r@r+r+r,reverses  zArcGIS.reversec Cst|s dSd|vrj|dddkrZzd|dddvr@WdSWnttfyXYn0tt|d|ddrd |d}n |dd }t||d d |d d f|d}|r|S|gSdS)NrBcodeizUnable to finddetailsrrEZAddressz=%(Address)s, %(City)s, %(Region)s %(Postal)s, %(CountryCode)sZ LongLabelrDrFrG)rHKeyError IndexErrorrr7getr )r(rJr-rErDr+r+r,rNs0  zArcGIS._parse_reverser5csjsjdSfdd}fddfddjdusfttjkrxj|jdS|SdS) Nr5cs>dtdjif}dji}j|tjd|dS)N&r&Referer) from_tokenrheaders)r8rr&r_call_geocoderrZcall_urlrY)maybe_reauthenticate_callbackr(rr?r+r,query_callback s  z;ArcGIS._authenticated_call_geocoder..query_callbackcs2d|vr*|ddjkr*j|dS|S)NrBrPrrW)_TOKEN_EXPIRED_refresh_authentication_token)rJrW)parse_callbackquery_retry_callbackr(rr+r,r\s zJArcGIS._authenticated_call_geocoder..maybe_reauthenticate_callbackcs4dtdjif}dji}j||dS)NrUr&rVrX)r8rr&rrZr[)rar(rr?r+r,rbs  zAArcGIS._authenticated_call_geocoder..query_retry_callbackr^)rrZr&intrr'r`)r(r?rarr]r+)r\rarbr(rr?r,r<s z#ArcGIS._authenticated_call_geocodercsn|jkrSjjjjdd}djt|ft dj j fdd}j ||dS)Nr/)rrrZ expirationr0r3z$%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&rcrrr')rJcallback_successr(r?r+r,cb>s  z0ArcGIS._refresh_authentication_token..cbr5) r&rrrrr8r!rr r9r*r:rZ)r(rfrrWZtoken_request_argumentsrgr+rer,r`+s  z$ArcGIS._refresh_authentication_token)NN)r: __module__ __qualname____doc__r_r r"r$rrrAr;rOrNr<r r` __classcell__r+r+r)r,r s>g ' #! &r )r/ functoolsrr urllib.parserZ geopy.excrrrZgeopy.geocoders.baserr r Zgeopy.locationr Z geopy.utilr __all__rMr r+r+r+r,s