a
î }cºB ã @ 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_SENTINELÚGeocoder)ÚLocation)Úlogger)Ú IGNFrancec s– e Zd ZdZdZdZd dddddeededdœ
‡ fdd„ Zd d
d dd ed
œdd„Zdd
dd edœdd„Z d dd„Z
d dd„Z dd„ Z d dd „Z
‡ ZS )!r z‰Geocoder 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)
ÚusernameÚpasswordÚrefererÚdomainÚschemeÚtimeoutÚproxiesÚ
user_agentÚ ssl_contextÚadapter_factoryc
sb t ƒ j|||| |
| d |s(|s(|s(|r8tjdtdd | 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 zïIGNFrance 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__ÚwarningsÚwarnÚDeprecationWarningÚstripr
Úapi_pathr Úapi)
ÚselfZapi_keyr
r r r
r r r r r r r ©Ú __class__© úU/var/www/html/django/DPS/env/lib/python3.9/site-packages/geopy/geocoders/ignfrance.pyr ' s" @ú ù
zIGNFrance.__init__Ú
StreetAddressé FT)Ú
query_typeÚmaximum_responsesÚ is_freeformÚ filteringÚ exactly_oner c C sÀ |dvrt dƒ‚|dkr0t| ¡ ƒdkr0t dƒ‚d}| jjd||d} |rPd }nd
}|d u r`d }| 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$ ÚCadastralParcelz˜You 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}
ZLocationUtilityService©Ú method_nameÚ sub_requestr' ÚtrueÚfalseNÚ )r( Úqueryr& r) Úxlsú?z%s.geocode: %s)r( r* ©r )r Úlenr Ú xml_requestÚformatÚjoinr r r Údebugr! Ú__name__r Ú
_parse_xmlÚ_request_raw_content)r r4 r& r' r( r) r* r r0 r9 Úrequest_stringÚparamsÚurlÚcallbackr" r" r# Úgeocode s: - ýüÿÿzIGNFrance.geocode)r$ r3 )Úreverse_geocode_preferencer' r) r* r c C s® d}| j jd||d}|D ]} | dvrtdƒ‚q| |d¡}
d dd „ |D ƒ¡}|j||
||d
} d | jtd | iƒf¡} t d
| 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}
ZReverseGeocodeRequestr. )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" )Ú.0Úprefr" r" r# Ú ) s ÿz$IGNFrance.reverse..)r' r4 rE r) r6 r5 z%s.reverse: %sTr2 )r* Ú
is_reverser( r7 )r9 r: r Z_coerce_point_to_stringr; r r r r< r! r= r r> r? )r r4 rE r' r) r* r r0 r9 rH Úpointr@ rB rC r" r" r# Úreverseå s< * ýÿ
ýüüzIGNFrance.reversec sz t | d¡¡}dd„ }||dƒ ||dƒ ||dƒ ˆj||d}|sLdS |rbˆj|d ˆ d
S ‡ ‡fd d „|D ƒS dS )
ze
Returns location, (latitude, longitude) from XML feed
and transform to json
zutf-8c S s> d| }t |ƒ}| ¡ D ] }|j |¡r|j|d… |_qdS )z*Remove namespace in the document in place.z{%s}N)r8 ÚiterÚtagÚ
startswith)ÚdocÚ namespaceÚnsZnslÚelemr" r" r# Úremove_namespaceN s
z.IGNFrance._parse_xml..remove_namespacezhttp://www.opengis.net/gmlzhttp://www.opengis.net/xlsz http://www.opengis.net/xlsext)rJ Nr ©r( c s g | ]}ˆj |ˆ d ‘qS )rU )Ú _parse_place)rG Úplace©r( r r" r# Ú
b s
ýþz(IGNFrance._parse_xml..)ÚETZ
fromstringÚencodeÚ_xml_to_json_placesrV )r ÚpagerJ r( r* ÚtreerT Úplacesr" rX r# r> A s
üzIGNFrance._parse_xmlc C s‚ |sdnd}| d| ¡}g }d}|D ]T}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< |
| d1¡d2ƒ| d3< |
| d4¡d5ƒ| d6< t| ¡ ƒD ](\} } | d7ur| j| | < nd7| | < qö| d rV| d d8¡\}
}|
¡ | d9< | ¡ | d:< nd7 | d9< | d:< | dd7¡ | | ¡ q&|S );zT
Transform the xml ElementTree due to XML webservice return to json
ZGeocodedAddressZReverseGeocodedLocationz.//z .//Address/Place[@type="{}"]z ./Point/posÚposz .//Address/StreetAddress/StreetÚstreetz.//Address/freeFormAddressÚfreeformaddressZ MunicipalityZ municipalityZNumeroÚnumeroZFeuilleZfeuilleZSectionÚsectionZ DepartementZ departementZCommuneAbsorbeeZcommune_absorbeeZCommuneÚcommuneZINSEEZinseeZQualiteZqualiteZ
TerritoireZ
territoireZIDÚidZID_TRZid_trZBboxZbboxZNatureZnaturez.//Address/PostalCodeÚ postal_codez.//ExtendedGeocodeMatchCodeZextended_geocode_match_codec S s | dur| j |d¡S dS )z
Helper to select by attribute and if not attribute,
value set to empty string
N)ZattribÚget)ÚselectorÚkeyr" r" r# ÚtestContentAttrib’ s ýþýz8IGNFrance._xml_to_json_places..testContentAttribz.//GeocodeMatchCodeZaccuracyZ matchTypeZ
match_typez!.//Address/StreetAddress/BuildingÚnumberÚbuildingz.//SearchCentreDistanceÚvalueZsearch_centre_distanceNú ÚlatÚlng)
ÚfindallÚfindr: rM ÚitemsÚtextÚsplitr ÚpopÚappend)r r^ rJ Z select_multiZadressesr_ Zsel_plZadrÚelrW rk rj rn rp rq r" r" r# r\ i sp ÿý
ÿ
ÿ
ÿ
ÿ
ÿ
z IGNFrance._xml_to_json_placesc C s | j |||ddS )z6
Send the request to get raw content.
F)r Zis_json)Z_call_geocoder)r rB rC r r" r" r# r? ¼ s üz IGNFrance._request_raw_contentc C sž |dkr| d¡}nn| d¡r*| d¡}nXd| dd¡| dd¡f }| d¡rdd | dd¡|f }| d
¡r‚d| d
d¡|f }t|| d ¡| d ¡f|ƒS )
zP
Get the location, lat, lng and place from a single json place.
r1 rb rc ra z%s %srg r3 re z%s, %srm rp rq )rh r )r rW r( Úlocationr" r" r# rV Ç s&
þ
þ
þzIGNFrance._parse_place)N)FFT)F)N)r= Ú
__module__Ú __qualname__Ú__doc__r9 r r r rD rL r> r\ r? rV Ú
__classcell__r" r" r r# r sH þó\÷ jø ^ ü
(
S r )r Zxml.etree.ElementTreeÚetreeZ ElementTreerZ Ú functoolsr Ú urllib.parser Z geopy.excr Zgeopy.geocoders.baser r Zgeopy.locationr Z
geopy.utilr Ú__all__r r" r" r" r# Ú s