o
4cB @ s~ d dl Z d dlm mZ d dlmZ d dlmZ d dl m
Z
d dl m Z m
Z
d dlmZ d dlmZ dZG d d
d
e
ZdS ) N)partial) urlencode)GeocoderQueryError)DEFAULT_SENTINELGeocoder)Location)logger) IGNFrancec s e Zd ZdZdZdZ d dddddeededd
fdd Zd d
d dd ed
ddZdd
dd edddZ d ddZ
d ddZ dd Z d dd Z
ZS ) r zGeocoder using the IGN France GeoCoder OpenLS API.
Documentation at:
https://geoservices.ign.fr/services-web-essentiels
aK
{sub_request}
z/essentiels/geoportail/olsNz
wxs.ign.fr)
usernamepasswordrefererdomainschemetimeoutproxies
user_agent ssl_contextadapter_factoryc
sb t j|||| |
| d |s|s|s|r tjdtdd |d| _| j} d| j| j| f | _ dS )a=
:param str api_key: Not used.
.. deprecated:: 2.3
IGNFrance geocoding methods no longer accept or require
authentication, see ``_.
This parameter is scheduled for removal in geopy 3.0.
:param str username: Not used.
.. deprecated:: 2.3
See the `api_key` deprecation note.
:param str password: Not used.
.. deprecated:: 2.3
See the `api_key` deprecation note.
:param str referer: Not used.
.. deprecated:: 2.3
See the `api_key` deprecation note.
:param str domain: Currently it is ``'wxs.ign.fr'``, can
be changed for testing purposes for developer API
e.g ``'gpp3-wxs.ign.fr'`` at the moment.
: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
)r r r r r r zIGNFrance no longer accepts or requires authentication, so api_key, username, password and referer are not used anymore. These arguments should be removed. In geopy 3 these options will be removed, causing an error instead of this warning. )
stacklevel/z %s://%s%sN)
super__init__warningswarnDeprecationWarningstripr
api_pathr api)
selfapi_keyr
r r r
r r r r r r r __class__ O/var/www/html/gps/gps/lib/python3.10/site-packages/geopy/geocoders/ignfrance.pyr ' s" @
zIGNFrance.__init__
StreetAddress FT)
query_typemaximum_responses is_freeform filtering exactly_oner c C s |dvrt d|dkrt| dkrt dd}| jjd||d} |r(d }nd
}|d u r0d }| j||||d
}
d|
i} d| jt| f} t d| j
j | t | j
||d}
| j| |
|dS )a>
Return a location point by address.
:param str query: The query string to be geocoded.
:param str query_type: The type to provide for geocoding. It can be
`PositionOfInterest`, `StreetAddress` or `CadastralParcel`.
`StreetAddress` is the default choice if none provided.
:param int maximum_responses: The maximum number of responses
to ask to the API in the query body.
:param str is_freeform: Set if return is structured with
freeform structure or a more structured returned.
By default, value is False.
:param str filtering: Provide string that help setting geocoder
filter. It contains an XML string. See examples in documentation
and ignfrance.py file in directory tests.
: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``.
)PositionOfInterestr% CadastralParcelzYou did not provided a query_type the
webservice can consume. It should be PositionOfInterest,
'StreetAddress or CadastralParcelr- zfYou must send a string of fourteen
characters long to match the cadastre required codea*
{query}
{filtering}
LocationUtilityService method_name sub_requestr( truefalseN )r) queryr' r* xls?z%s.geocode: %s)r) r+ r )r lenr xml_requestformatjoinr r r debugr" __name__r
_parse_xml_request_raw_content)r r6 r' r( r) r* r+ r r2 r; request_stringparamsurlcallbackr# r# r$ geocode s: - zIGNFrance.geocode)r% r5 )reverse_geocode_preferencer( r* r+ r c C s d}| j jd||d}|D ]
} | dvrtdq
| |d}
ddd |D }|j||
||d
} d | jtd | if} td
| j j
| t | j |ddd}
| j
| |
|dS )aU
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 list reverse_geocode_preference: Enable to set expected results
type. It can be `StreetAddress` or `PositionOfInterest`.
Default is set to `StreetAddress`.
:param int maximum_responses: The maximum number of responses
to ask to the API in the query body.
:param str filtering: Provide string that help setting geocoder
filter. It contains an XML string. See examples in documentation
and ignfrance.py file in directory tests.
: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``.
a@
{reverse_geocode_preference}
{query}
{filtering}
ReverseGeocodeRequestr0 )r% r, z[`reverse_geocode_preference` must contain one or more of: StreetAddress, PositionOfInterestz%(lat)s %(lon)s
c s s | ]}d | V qdS )z7%sNr# ).0prefr# r# r$ ) s
z$IGNFrance.reverse..)r( r6 rG r* r8 r7 z%s.reverse: %sTr4 )r+
is_reverser) r9 )r; r< r _coerce_point_to_stringr= r r r r> r" r? r r@ rA )r r6 rG r( r* r+ r r2 r; rK pointrB rD rE r# r# r$ reverse s> *
zIGNFrance.reversec sv t |d}dd }||d ||d ||d j||d}|s&dS |r1j|d d
S fd d |D S )
ze
Returns location, (latitude, longitude) from XML feed
and transform to json
zutf-8c S s> d| }t |}| D ]}|j|r |j|d |_q dS )z*Remove namespace in the document in place.z{%s}N)r: itertag
startswith)doc namespacensnslelemr# r# r$ remove_namespaceN s z.IGNFrance._parse_xml..remove_namespacezhttp://www.opengis.net/gmlzhttp://www.opengis.net/xlsz http://www.opengis.net/xlsext)rM Nr r) c s g | ] }j | d qS )rZ ) _parse_place)rJ placer) r r# r$
b s z(IGNFrance._parse_xml..)ET
fromstringencode_xml_to_json_placesr[ )r pagerM r) r+ treerY placesr# r] r$ r@ A s
zIGNFrance._parse_xmlc C s |sdnd}| d| }g }d}|D ])}i }|d|d< |d|d< |d |d
< ||d |d < ||d
|d< ||d|d< ||d|d< ||d|d< ||d|d< ||d|d< ||d|d< ||d|d < ||d |d < ||d |d < ||d!|d"< ||d#|d$< ||d%|d&< |d'|d(< |d)|d*< i } d+d, }
|
|d-d.| d.< |
|d-d/| d0< |
|d1d2| d3< |
|d4d5| d6< t| D ]\} } | d7ur
| j| | < qd7| | < q| d r*| d d8\}
}|
| d9< | | d:< nd7 | d9< | d:< | dd7 | | q|S );zT
Transform the xml ElementTree due to XML webservice return to json
GeocodedAddressReverseGeocodedLocationz.//z .//Address/Place[@type="{}"]z ./Point/posposz .//Address/StreetAddress/Streetstreetz.//Address/freeFormAddressfreeformaddress Municipality municipalityNumeronumeroFeuillefeuilleSectionsection Departement departementCommuneAbsorbeecommune_absorbeeCommunecommuneINSEEinseeQualitequalite
Territoire
territoireIDidID_TRid_trBboxbboxNaturenaturez.//Address/PostalCode postal_codez.//ExtendedGeocodeMatchCodeextended_geocode_match_codec S s | dur | j |dS dS )z
Helper to select by attribute and if not attribute,
value set to empty string
N)attribget)selectorkeyr# r# r$ testContentAttrib s z8IGNFrance._xml_to_json_places..testContentAttribz.//GeocodeMatchCodeaccuracy matchType
match_typez!.//Address/StreetAddress/Buildingnumberbuildingz.//SearchCentreDistancevaluesearch_centre_distanceN latlng)
findallfindr< rQ itemstextsplitr popappend)r rd rM select_multiadressesre sel_pladrelr\ r r r r r r# r# r$ rb i sp
z IGNFrance._xml_to_json_placesc C s | j |||ddS )z6
Send the request to get raw content.
F)r is_json)_call_geocoder)r rD rE r r# r# r$ rA s z IGNFrance._request_raw_contentc C s |dkr
| d}n7| dr| d}n,d| dd| ddf }| dr2d | dd|f }| d
rAd| d
d|f }t|| d | d f|S )
zP
Get the location, lat, lng and place from a single json place.
r3 rj rn ri z%s %sr r5 rx z%s, %sr r r )r r )r r\ r) locationr# r# r$ r[ s&
zIGNFrance._parse_place)N)FFT)F)r?
__module__ __qualname____doc__r; r r r rF rP r@ rb rA r[
__classcell__r# r# r! r$ r sJ \ j ^
(S r )r xml.etree.ElementTreeetree ElementTreer_ functoolsr urllib.parser geopy.excr geopy.geocoders.baser r geopy.locationr
geopy.utilr __all__r r# r# r# r$ s