ESCatastroLib 0.0.1rc0__py3-none-any.whl

ESCatastroLib/__init__.py

@@ -0,0 +1,3 @@
+# ESCatastroLib/__init__.py
+from .models import Calle, Municipio, ParcelaCatastral, MetaParcela
+from .utils import exceptions, statics, utils

ESCatastroLib/models/Calle.py

@@ -0,0 +1,49 @@
+from .Municipio import Municipio
+from ..utils.statics import URL_BASE_CALLEJERO
+from ..utils.utils import comprobar_errores
+
+import requests
+import json
+
+class Calle:
+    """
+    Clase que representa una calle.
+    Args:
+        municipio (Municipio): Objeto que representa el municipio al que pertenece la calle.
+        nombre_calle (str, optional): Nombre de la calle. Default es None.
+        tipo_via (str, optional): Tipo de vía de la calle. Default es None.
+    Raises:
+        Exception: Se produce cuando ocurre un error al asignar la calle.
+        Exception: Se produce cuando no se especifica el nombre de la calle.
+        Exception: Se produce cuando no se encuentran calles disponibles.
+    Attributes:
+        calle (str): Nombre de la calle asignada.
+        tipo_via (str): Tipo de vía de la calle asignada.
+        municipio (Municipio): Objeto que representa el municipio al que pertenece la calle.
+    """
+
+    def __init__(self, municipio: Municipio, nombre_calle: str|None = None, tipo_via: str|None = None):
+        uri = f'{URL_BASE_CALLEJERO}/ObtenerCallejero'
+
+        request = requests.get(uri, params={
+            'Provincia': municipio.provincia,
+            'Municipio': municipio.municipio,
+            'NomVia': nombre_calle,
+            'TipoVia': tipo_via
+        })
+
+        if request.status_code == 200:
+            calle_dict = json.loads(request.text)
+
+            if comprobar_errores(calle_dict) and nombre_calle:
+                if len(calle_dict.get('consulta_callejeroResult').get('callejero').get('calle')) == 1:
+                    self.calle = calle_dict.get('consulta_callejeroResult').get('callejero').get('calle')[0].get('dir').get('nv')
+                    self.tipo_via = calle_dict.get('consulta_callejeroResult').get('callejero').get('calle')[0].get('dir').get('tv')
+                    self.municipio = municipio
+                else:
+                    raise Exception(f"""Error al asignar calle. No has especificado la calle completamente, o ese nombre está en varios lados (indica el tipo de vía que aparezca al principio de la vía como PZ o CL). Estas son las calles disponibles con esa búsqueda: {','.join(f"{cl.get('dir').get('tv')} {cl.get('dir').get('nv')}" for cl in calle_dict.get('consulta_callejeroResult').get('callejero').get('calle'))}""")
+            else:
+                raise Exception(f"""Error al asignar calle. No has especificado la calle. Estas son las calles disponibles: {','.join(f"{cl.get('dir').get('tv')} {cl.get('dir').get('nv')}" for cl in calle_dict.get('consulta_callejeroResult').get('callejero').get('calle'))}""")
+            
+        else:
+            raise Exception(f'Error al listar calles: Puede que no exista ese municipio.')

ESCatastroLib/models/InfoCatastral.py

@@ -0,0 +1,303 @@
+import requests
+import json
+import xmltodict
+
+from ..utils.statics import URL_BASE_CALLEJERO, URL_BASE_GEOGRAFIA, URL_BASE_CROQUIS_DATOS
+from ..utils.utils import comprobar_errores
+from ..utils.exceptions import ErrorServidorCatastro
+from .Calle import Calle, Municipio
+
+class ParcelaCatastral:
+    """
+    Clase que representa una parcela catastral.
+    Args:
+        rc (str, optional): La referencia catastral de la parcela. Defaults to None. Puede ir solo.
+
+        provincia (int|str, optional): El código o nombre de la provincia. Defaults to None. Se usa para buscar por dirección o parcela.
+        municipio (int|str, optional): El código o nombre del municipio. Defaults to None. Se usa para buscar por dirección o parcela.
+        poligono (int, optional): El número del polígono. Defaults to None. Se usa para buscar por parcela.
+        parcela (int, optional): El número de la parcela. Defaults to None. Se usa para buscar por parcela.
+        tipo_via (str, optional): El tipo de vía de la dirección. Defaults to None. Se usa para buscar por dirección.
+        calle (str, optional): El nombre de la calle de la dirección. Defaults to None. Se usa para buscar por dirección.
+        numero (str, optional): El número de la dirección. Defaults to None. Se usa para buscar por dirección.
+    Raises:
+        ValueError: Se lanza si no se proporciona suficiente información para realizar la búsqueda o si la RC corresponde a una MetaParcela.
+        ErrorServidorCatastro: Se lanza si hay un error en el servidor del Catastro.
+    Attributes:
+        rc (str): La referencia catastral de la parcela.
+        provincia (int|str): El código o nombre de la provincia.
+        municipio (int|str): El código o nombre del municipio.
+        poligono (int): El número del polígono. Sólo se da en terrenos Rústicos.
+        parcela (int): El número de la parcela. Sólo se da en terrenos Rústicos.
+        tipo_via (str): El tipo de vía de la dirección. Sólo se da en terrenos Urbanos.
+        calle (str): El nombre de la calle de la dirección. Sólo se da en terrenos Urbanos.
+        numero (str): El número de la dirección. Sólo se da en terrenos Urbanos.
+        url_croquis (str): La URL del croquis de la parcela.
+        tipo (str): El tipo de la parcela (Urbano o Rústico).
+        antiguedad (str): La antigüedad de la parcela (solo para parcelas urbanas).
+        uso (str): El uso de la parcela (solo para parcelas urbanas).
+        nombre_paraje (str): El nombre del paraje (solo para parcelas rústicas).
+        regiones (list): Una lista de regiones de la parcela, cada una con una descripción y superficie.
+        geocentro (dict): Las coordenadas del geocentro de la parcela.
+        geometria (list): Una lista de puntos que representan la geometría de la parcela.
+    """
+
+    def __create_regions(self, info_cadastre: dict):
+        self.regiones = []
+        if self.tipo == 'Urbano':
+            iterator = list(info_cadastre.values())[0].get('bico').get('lcons')
+        elif self.tipo == 'Rústico':
+            iterator = list(info_cadastre.values())[0].get('bico').get('lspr')
+        for region in iterator:
+            if self.tipo == 'Rústico':
+                self.regiones.append({
+                        'descripcion': region.get('dspr').get('dcc'),
+                        'superficie': region.get('dspr').get('ssp')
+                    })
+            elif self.tipo == 'Urbano':
+                self.regiones.append({
+                        'descripcion': region.get('lcd'),
+                        'superficie': region.get('dfcons').get('stl')
+                    })
+
+
+    def __create_geometry(self):
+        geometry_request = requests.get(f'{URL_BASE_GEOGRAFIA}',
+                                        params={
+                                            'service':'wfs',
+                                            'version':'2',
+                                            'request':'getfeature',
+                                            'STOREDQUERIE_ID':'GetParcel',
+                                            'refcat': self.rc,
+                                            'srsname': 'EPSG:4326'
+                                        })
+
+        geometry = xmltodict.parse(geometry_request.content)
+        geoposition = geometry.get('FeatureCollection').get('member').get('cp:CadastralParcel').get('cp:referencePoint').get('gml:Point').get('gml:pos').split(' ')
+        self.geocentro = {
+            'x': geoposition[0],
+            'y': geoposition[1]
+        }
+        parcel_geometry = geometry.get('FeatureCollection').get('member').get('cp:CadastralParcel').get('cp:geometry').get('gml:MultiSurface').get('gml:surfaceMember').get('gml:Surface').get('gml:patches').get('gml:PolygonPatch').get('gml:exterior').get('gml:LinearRing').get('gml:posList').get('#text').split(' ')
+        self.geometria = [
+            {
+                'x': parcel_geometry[2*idx],
+                'y': parcel_geometry[2*idx+1]
+            } for idx in range(len(parcel_geometry)//2)
+        ]
+
+    def __create_from_rc(self, rc: str):
+        """Create an instance of InfoCatastral from a RC (Referencia Catastral) string."""
+        req1 = requests.get(f'{URL_BASE_CALLEJERO}/Consulta_DNPRC',
+                            params={'RefCat': rc})
+        
+        info_cadastre = json.loads(req1.content)
+        if comprobar_errores(info_cadastre):
+            cudnp = info_cadastre.get("consulta_dnprcResult", {}).get("control", {}).get("cudnp", 1)
+        
+            if cudnp > 1:
+                raise ErrorServidorCatastro(mensaje="Esta parcela tiene varias referencias catastrales. Usa un objeto MetaParcela.")
+            else:
+                self.url_croquis = requests.get(URL_BASE_CROQUIS_DATOS, params={'refcat': self.rc}).url
+                self.municipio = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('nm')
+                self.provincia = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('np')
+                self.tipo = 'Rústico' if info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('idbi').get('cn') == 'RU' else 'Urbano'
+                if self.tipo == 'Urbano':
+                    self.calle = f"{info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('locs').get('lous').get('lourb').get('dir').get('tv')} {info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('locs').get('lous').get('lourb').get('dir').get('nv')}"
+                    self.numero = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('locs').get('lous').get('lourb').get('dir').get('pnp')
+                    self.antiguedad = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('debi').get('ant')
+                    self.uso = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('debi').get('luso')
+                elif self.tipo == 'Rústico':
+                    self.parcela = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('locs').get('lors').get('lorus').get('cpp').get('cpa')
+                    self.poligono = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('locs').get('lors').get('lorus').get('cpp').get('cpo')
+                    self.nombre_paraje = info_cadastre.get('consulta_dnprcResult').get('bico').get('bi').get('dt').get('locs').get('lors').get('lorus').get('npa')
+                
+                self.__create_regions(info_cadastre)
+                self.__create_geometry()
+
+                self.superficie = sum(float(region.get('superficie')) for region in self.regiones)
+
+    def __create_from_parcel(self, provincia: str|None, municipio: str|None, poligono: str|None, parcela: str|None):
+        """Create an instance of InfoCatastral from a parcela string."""
+        req = requests.get(f'{URL_BASE_CALLEJERO}/Consulta_DNPPP',
+                           params={
+                               'Provincia': provincia,
+                               'Municipio': municipio,
+                               'Poligono': poligono,
+                               'Parcela': parcela
+                           })
+        
+        info_cadastre = json.loads(req.content)
+        if comprobar_errores(info_cadastre):
+            cudnp = info_cadastre.get("consulta_dnpppResult", {}).get("control", {}).get("cudnp", 1)
+
+            if cudnp > 1:
+                raise ErrorServidorCatastro(mensaje="Esta parcela tiene varias referencias catastrales. Usa un objeto MetaParcela.")
+            else:
+                self.rc = ''.join(info_cadastre.get('consulta_dnpppResult').get('bico').get('bi').get('idbi').get('rc').values())
+                self.__create_from_rc(self.rc)
+
+    def __create_from_address(self, provincia: str|None, municipio: str|None, tipo_via: str|None, calle: str|None, numero: str|None):
+        """Create an instance of InfoCatastral from an address string."""
+        info_calle = Calle(
+            municipio=Municipio(
+                provincia=provincia,
+                municipio=municipio
+            ),
+            tipo_via=tipo_via,
+            nombre_calle=calle
+        )
+
+        if info_calle:
+            req = requests.get(f'{URL_BASE_CALLEJERO}/Consulta_DNPLOC',
+                               params={
+                                   'Provincia': info_calle.municipio.provincia,
+                                   'Municipio': info_calle.municipio.municipio,
+                                   'Sigla': info_calle.tipo_via,
+                                   'Calle': info_calle.calle,
+                                   'Numero': numero
+                               })
+            
+            if req.status_code == 200 and comprobar_errores(req.json()):
+                info_cadastre = json.loads(req.content)
+                cudnp = info_cadastre.get("consulta_dnplocResult", {}).get("control", {}).get("cudnp", 1)
+
+                if cudnp > 1:
+                    raise ErrorServidorCatastro(mensaje="Esta parcela tiene varias referencias catastrales. Usa un objeto MetaParcela.")
+                else:
+                    if 'lrcdnp' in info_cadastre.get('consulta_dnplocResult'):
+                        self.rc = ''.join(info_cadastre.get('consulta_dnplocResult').get('lrcdnp').get('rcdnp')[0].get('rc').values())
+                    elif 'bico' in info_cadastre.get('consulta_dnplocResult'):
+                        self.rc = ''.join(info_cadastre.get('consulta_dnplocResult').get('bico').get('bi').get('idbi').get('rc').values())
+                    self.__create_from_rc(self.rc)
+            elif 'lerr' in json.loads(req.content).get('consulta_dnplocResult') and json.loads(req.content)['consulta_dnplocResult']['lerr'][0]['cod'] == '43':
+                info_cadastre = json.loads(req.content)
+                raise Exception(f"Ese número no existe. Prueba con alguno de estos: {[num.get('num').get('pnp') for num in info_cadastre.get('consulta_dnplocResult').get('numerero').get('nump')]}")
+
+                
+        else:
+            raise Exception('La calle no existe.')
+
+    def __init__(self, rc: str|None = None, provincia: int|str|None = None, municipio: int|str|None = None, poligono: int|None = None, parcela: int|None = None, tipo_via: str|None = None, calle: str|None = None, numero: str|None = None):
+        if rc:
+            self.rc = rc
+            self.__create_from_rc(rc)
+        elif provincia and municipio and poligono and parcela:
+            self.provincia = provincia
+            self.municipio = municipio
+            self.poligono = poligono
+            self.parcela = parcela
+            self.__create_from_parcel(provincia, municipio, poligono, parcela)
+        elif provincia and municipio and tipo_via and calle and numero:
+            self.provincia = provincia
+            self.municipio = municipio
+            self.calle = calle
+            self.numero = numero
+            self.__create_from_address(provincia, municipio, tipo_via, calle, numero)
+        else:
+            raise ValueError("No se ha proporcionado suficiente información para realizar la búsqueda")
+        
+class MetaParcela:
+    """
+    Clase que representa una MetaParcela, es decir, una gran parcela catastral con 
+    varias referencias catastrales (Parcelas Catastrales más pequeñas).
+
+    Args:
+        rc (str|None): La referencia catastral de la MetaParcela.
+
+        provincia (int|str|None): El nombre de la provincia donde se encuentra la MetaParcela.
+        municipio (int|str|None): El nombre del municipio donde se encuentra la MetaParcela.
+        poligono (int|None): El número de polígono de la MetaParcela. Sólo se usa para buscar por parcela.
+        parcela (int|None): El número de parcela de la MetaParcela. Sólo se usa para buscar por parcela.
+        tipo_via (str|None): El tipo de vía de la dirección de la MetaParcela. Sólo se usa para buscar por dirección.
+        calle (str|None): El nombre de la calle de la dirección de la MetaParcela. Sólo se usa para buscar por dirección.
+        numero (str|None): El número de la dirección de la MetaParcela. Sólo se usa para buscar por dirección.
+    Attributes:
+        rc (str): La referencia catastral de la MetaParcela.
+        parcelas (list): Una lista de ParcelaCatastral que representan las parcelas que componen la MetaParcela.
+
+    """
+
+    def __create_from_rc(self, rc: str):
+        """Create an instance of InfoCatastral from a RC (Referencia Catastral) string."""
+        req1 = requests.get(f'{URL_BASE_CALLEJERO}/Consulta_DNPRC',
+                            params={'RefCat': rc})
+    
+        info_cadastre = json.loads(req1.content)
+        if comprobar_errores(info_cadastre):
+            self.parcelas = []
+            num_parcelas = info_cadastre.get("consulta_dnprcResult", {}).get("control", {}).get("cudnp", 1)
+            for idx in range(num_parcelas):
+                rc = ''.join(info_cadastre.get('consulta_dnprcResult').get('lrcdnp').get('rcdnp')[idx].get('rc').values())
+                self.parcelas.append(ParcelaCatastral(rc=rc))
+                
+
+    def __create_from_parcel(self, provincia: str|None, municipio: str|None, poligono: str|None, parcela: str|None):
+        """Create an instance of InfoCatastral from a parcela string."""
+        req = requests.get(f'{URL_BASE_CALLEJERO}/Consulta_DNPPP',
+                           params={
+                               'Provincia': provincia,
+                               'Municipio': municipio,
+                               'Poligono': poligono,
+                               'Parcela': parcela
+                           })
+        
+        info_cadastre = json.loads(req.content)
+        if comprobar_errores(info_cadastre):
+            self.parcelas = []
+            num_parcelas = info_cadastre.get("consulta_dnpppResult", {}).get("control", {}).get("cudnp", 1)
+            for idx in range(num_parcelas):
+                rc = ''.join(info_cadastre.get('consulta_dnpppResult').get('lrcdnp').get('rcdnp')[idx].get('rc').values())
+                self.parcelas.append(ParcelaCatastral(rc=rc))
+
+    def __create_from_address(self, provincia: str|None, municipio: str|None, tipo_via: str|None, calle: str|None, numero: str|None):
+        """Create an instance of InfoCatastral from an address string."""
+        info_calle = Calle(
+            municipio=Municipio(
+                provincia=provincia,
+                municipio=municipio
+            ),
+            tipo_via=tipo_via,
+            nombre_calle=calle
+        )
+
+        if info_calle:
+            req = requests.get(f'{URL_BASE_CALLEJERO}/Consulta_DNPLOC',
+                               params={
+                                   'Provincia': info_calle.municipio.provincia,
+                                   'Municipio': info_calle.municipio.municipio,
+                                   'Sigla': info_calle.tipo_via,
+                                   'Calle': info_calle.calle,
+                                   'Numero': numero
+                               })
+            
+            if req.status_code == 200 and comprobar_errores(req.json()):
+                info_cadastre = json.loads(req.content)
+                self.parcelas = []
+                num_parcelas = info_cadastre.get("consulta_dnplocResult", {}).get("control", {}).get("cudnp", 1)
+                for idx in range(num_parcelas):
+                    rc = ''.join(info_cadastre.get('consulta_dnplocResult').get('lrcdnp').get('rcdnp')[idx].get('rc').values())
+                    self.parcelas.append(ParcelaCatastral(rc=rc))
+                
+        else:
+            raise Exception('La calle no existe.')
+
+    def __init__(self, rc: str|None = None, provincia: int|str|None = None, municipio: int|str|None = None, poligono: int|None = None, parcela: int|None = None, tipo_via: str|None = None, calle: str|None = None, numero: str|None = None):
+        if rc:
+            self.rc = rc
+            self.__create_from_rc(rc)
+        elif provincia and municipio and poligono and parcela:
+            self.provincia = provincia
+            self.municipio = municipio
+            self.poligono = poligono
+            self.parcela = parcela
+            self.__create_from_parcel(provincia, municipio, poligono, parcela)
+        elif provincia and municipio and tipo_via and calle and numero:
+            self.provincia = provincia
+            self.municipio = municipio
+            self.calle = calle
+            self.numero = numero
+            self.__create_from_address(provincia, municipio, tipo_via, calle, numero)
+        else:
+            raise ValueError("No se ha proporcionado suficiente información para realizar la búsqueda")
+        

ESCatastroLib/models/Municipio.py

@@ -0,0 +1,29 @@
+from ..utils.utils import listar_municipios
+
+class Municipio:
+    """
+    Clase que representa un municipio.
+    Args:
+        provincia (str): El nombre de la provincia a la que pertenece el municipio.
+        municipio (str, optional): El nombre del municipio. Si no se proporciona, se lanzará una excepción con el municipio.
+    Attributes:
+        provincia (str): El nombre de la provincia a la que pertenece el municipio.
+        municipio (str): El nombre del municipio.
+    Raises:
+        Exception: Si no se especifica el municipio o si el municipio especificado no está disponible o si no se ha especificado completamente (te dará una lista de coincidencias).
+    """
+
+    def __init__(self, provincia: str, municipio: str|None = None):
+        municipios = listar_municipios(provincia=provincia,municipio=municipio)
+
+        if municipio:
+            if len(municipios) == 1:
+                self.provincia = provincia
+                self.municipio = municipios[0]
+            elif municipio.upper() in municipios:
+                self.provincia = provincia
+                self.municipio = municipio.upper()
+            else:
+                raise Exception(f"Error al asignar municipio. No has especificado el municipio completamente. Estos son los municipios disponibles con esa búsqueda: {','.join(municipios)}")
+        else:
+            raise Exception(f"Error al asignar municipio. No has especificado el municipio. Estos son los municipios disponibles: {','.join(municipios)}")

ESCatastroLib/models/__init__.py

@@ -0,0 +1,4 @@
+# ESCatastroLib/models/__init__.py
+from .Calle import Calle
+from .Municipio import Municipio
+from .InfoCatastral import ParcelaCatastral, MetaParcela

ESCatastroLib/utils/__init__.py

@@ -0,0 +1,4 @@
+# ESCatastroLib/utils/__init__.py
+from .exceptions import *
+from .statics import *
+from .utils import *

ESCatastroLib/utils/exceptions.py

@@ -0,0 +1,21 @@
+class ErrorServidorCatastro(Exception):
+    """
+    Clase de excepción personalizada para errores relacionados con el servidor del Catastro.
+    Atributos:
+    - mensaje (str): Mensaje de error específico del servidor del Catastro.
+    """
+
+    def __init__(self, mensaje=''):
+        self.message = f'Error del Catastro. {mensaje}'
+        super().__init__(self.message)
+
+def lanzar_excepcion(mensaje_error: str) -> Exception:
+    """
+    Lanza una excepción personalizada con el mensaje de error proporcionado.
+    Args:
+        mensaje_error (str): El mensaje de error que se incluirá en la excepción.
+    Returns:
+        Exception: La excepción personalizada con el mensaje de error.
+    """
+
+    return ErrorServidorCatastro(mensaje=mensaje_error)

ESCatastroLib/utils/statics.py

@@ -0,0 +1,122 @@
+URL_BASE_CALLEJERO = 'https://ovc.catastro.meh.es/OVCServWeb/OVCWcfCallejero/COVCCallejero.svc/json'
+URL_BASE_GEOGRAFIA = 'http://ovc.catastro.meh.es/INSPIRE/wfsCP.aspx'
+URL_BASE_CROQUIS_DATOS = f'https://www1.sedecatastro.gob.es/CYCBienInmueble/SECImprimirCroquisYDatos.aspx'
+
+MAPEOS_PROVINCIAS = {
+    'La Coruña': 'A Coruña',
+    'Orense': 'Ourense',
+    'Santa Cruz De Tenerife': 'S.C. Tenerife',
+    'Las Palmas De Gran Canaria': 'Las Palmas',
+    'Alicante': 'Alacant',
+    'Almería': 'Almeria',
+    'Cádiz': 'Cadiz',
+    'Córdoba': 'Cordoba',
+    'Gerona': 'Girona',
+    'Castellón De La Plana': 'Castello',
+    'Castellón': 'Castello',
+    'Lérida': 'Lleida',
+    'Málaga': 'Malaga',
+    'León': 'Leon',
+    'Ávila': 'Avila',
+    'Cáceres': 'Caceres',
+    'Baleares': 'Illes Balears',
+    'Islas Baleares': 'Illes Balears',
+    'Jaén': 'Jaen',
+    'València': 'Valencia'
+}
+
+TIPOS_VIA = {
+    "AC": "ACCESO",
+    "AG": "AGREGADO",
+    "AL": "ALDEA, ALAMEDA",
+    "AN": "ANDADOR",
+    "AR": "AREA, ARRABAL",
+    "AU": "AUTOPISTA",
+    "AV": "AVENIDA",
+    "AY": "ARROYO",
+    "BJ": "BAJADA",
+    "BL": "BLOQUE",
+    "BO": "BARRIO",
+    "BQ": "BARRANQUIL",
+    "BR": "BARRANCO",
+    "CA": "CAÑADA",
+    "CG": "COLEGIO, CIGARRAL",
+    "CH": "CHALET",
+    "CI": "CINTURON",
+    "CJ": "CALLEJA, CALLEJON",
+    "CL": "CALLE",
+    "CM": "CAMINO, CARMEN",
+    "CN": "COLONIA",
+    "CO": "CONCEJO, COLEGIO",
+    "CP": "CAMPA, CAMPO",
+    "CR": "CARRETERA, CARRERA",
+    "CS": "CASERIO",
+    "CT": "CUESTA, COSTANILLA",
+    "CU": "CONJUNTO",
+    "CY": "CALEYA",
+    "CZ": "CALLIZO",
+    "DE": "DETRÁS",
+    "DP": "DIPUTACION",
+    "DS": "DISEMINADOS",
+    "ED": "EDIFICIOS",
+    "EM": "EXTRAMUROS",
+    "EN": "ENTRADA, ENSANCHE",
+    "EP": "ESPALDA",
+    "ER": "EXTRARRADIO",
+    "ES": "ESCALINATA",
+    "EX": "EXPLANADA",
+    "FC": "FERROCARRIL",
+    "FN": "FINCA",
+    "GL": "GLORIETA",
+    "GR": "GRUPO",
+    "GV": "GRAN VIA",
+    "HT": "HUERTA, HUERTO",
+    "JR": "JARDINES",
+    "LA": "LAGO",
+    "LD": "LADO, LADERA",
+    "LG": "LUGAR",
+    "MA": "MALECON",
+    "MC": "MERCADO",
+    "ML": "MUELLE",
+    "MN": "MUNICIPIO",
+    "MS": "MASIAS",
+    "MT": "MONTE",
+    "MZ": "MANZANA",
+    "PB": "POBLADO",
+    "PC": "PLACETA",
+    "PD": "PARTIDA",
+    "PI": "PARTICULAR",
+    "PJ": "PASAJE, PASADIZO",
+    "PL": "POLIGONO",
+    "PM": "PARAMO",
+    "PQ": "PARROQUIA, PARQUE",
+    "PR": "PROLONGACION, CONTINUAC.",
+    "PS": "PASEO",
+    "PT": "PUENTE",
+    "PU": "PASADIZO",
+    "PZ": "PLAZA",
+    "QT": "QUINTA",
+    "RA": "RACONADA",
+    "RB": "RAMBLA",
+    "RC": "RINCON, RINCONA",
+    "RD": "RONDA",
+    "RM": "RAMAL",
+    "RP": "RAMPA",
+    "RR": "RIERA",
+    "RU": "RUA",
+    "SA": "SALIDA",
+    "SC": "SECTOR",
+    "SD": "SENDA",
+    "SL": "SOLAR",
+    "SN": "SALON",
+    "SU": "SUBIDA",
+    "TN": "TERRENOS",
+    "TO": "TORRENTE",
+    "TR": "TRAVESIA",
+    "UR": "URBANIZACION",
+    "VA": "VALLE",
+    "VD": "VIADUCTO",
+    "VI": "VIA",
+    "VL": "VIAL",
+    "VR": "VEREDA"
+}

ESCatastroLib/utils/utils.py

@@ -0,0 +1,102 @@
+import requests
+import json
+
+from .statics import URL_BASE_CALLEJERO, MAPEOS_PROVINCIAS, TIPOS_VIA
+from .exceptions import lanzar_excepcion
+
+def comprobar_errores(respuesta: dict):
+    """
+    Comprueba si la respuesta contiene errores.
+
+    Args:
+        respuesta (dict): El diccionario de respuesta.
+
+    Raises:
+        lanzar_excepcion: Si se encuentra un error en la respuesta.
+
+    Returns:
+        bool: True si no se encuentran errores, False en caso contrario.
+    """
+    # Check if the response contains the expected structure
+    if len(list(respuesta.values())) > 0:
+        if list(respuesta.values())[0] is not None and 'lerr' in list(respuesta.values())[0].keys():
+            if 'err' in list(respuesta.values())[0]['lerr']:
+                raise lanzar_excepcion(mensaje_error=list(respuesta.values())[0]['lerr']['err'][0]['des'])
+            else:
+                raise lanzar_excepcion(mensaje_error=list(respuesta.values())[0]['lerr'][0]['des'])
+        return True
+
+def listar_provincias():
+    """
+    Obtiene una lista de provincias.
+    Returns:
+        list: Una lista de nombres de provincias.
+    Raises:
+        None
+    """
+    
+    response = requests.get(f'{URL_BASE_CALLEJERO}/ObtenerProvincias')
+    return [provincia.get('np') for provincia in response.json().get('consulta_provincieroResult').get('provinciero').get('prov')] if comprobar_errores(response.json()) else []
+
+def listar_municipios(provincia: str, municipio: str|None = None):
+
+    """
+    Obtiene una lista de municipios de España.
+    Args:
+        provincia (str): El nombre de la provincia. Preferentemente en mayúsculas o capitalizado.
+        municipio (str, optional): El nombre del municipio. Por defecto es None.
+    Returns:
+        List[str]: Una lista de nombres de municipios.
+    Raises:
+        Exception: Si la provincia no existe. Muestra un mensaje con las provincias disponibles.
+    """
+
+    if provincia and provincia.capitalize() not in MAPEOS_PROVINCIAS and provincia.upper() not in listar_provincias():
+            raise Exception(f'La provincia {provincia} no existe. Las provincias de España son: {listar_provincias()}')
+    
+    response = requests.get(f'{URL_BASE_CALLEJERO}/ObtenerMunicipios', 
+                                params={
+                                    'provincia' : MAPEOS_PROVINCIAS.get(provincia.capitalize()) 
+                                                    if MAPEOS_PROVINCIAS.get(provincia.capitalize(),None) != None 
+                                                    else provincia ,
+                                    'municipio': municipio
+                                })
+    if response.status_code == 200 and comprobar_errores(response.json()):
+        mun_dict_raw = json.loads(response.content)
+        return [mun.get('nm') for mun in mun_dict_raw.get('consulta_municipieroResult').get('municipiero').get('muni')]
+    else:
+         return []
+    
+
+def listar_tipos_via():
+    """
+    Retorna una lista de los tipos de vía disponibles.
+    Returns:
+        list: Una lista de los tipos de vía disponibles.
+    """
+
+    return TIPOS_VIA
+
+def listar_calles(provincia: str, municipio: str):
+    """
+    Devuelve una lista de calles para una provincia y municipio dados.
+    Args:
+        provincia (str): El nombre de la provincia.
+        municipio (str): El nombre del municipio.
+    Returns:
+        list: Una lista de calles en formato "tipo de vía nombre de vía".
+    """
+
+    provincia_final = MAPEOS_PROVINCIAS.get(provincia.capitalize()) if provincia.capitalize() in MAPEOS_PROVINCIAS.keys() else provincia
+    if provincia_final.upper() in listar_provincias() and municipio.upper() in listar_municipios(provincia=provincia_final):
+        response = requests.get(f'{URL_BASE_CALLEJERO}/ObtenerCallejero',
+                                params={
+                                    'Provincia': provincia_final,
+                                    'Municipio': municipio
+                                })
+        if response.status_code == 200 and comprobar_errores(response.json()):
+            calles_dict_raw = json.loads(response.content)
+            return [f"{calle.get('dir').get('tv')} {calle.get('dir').get('nv')}" for calle in calles_dict_raw.get('consulta_callejeroResult').get('callejero').get('calle')]
+        else:
+            return []
+    else: return []

ESCatastroLib-0.0.1rc0.dist-info/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Iván Valero Rodríguez
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

ESCatastroLib-0.0.1rc0.dist-info/METADATA

@@ -0,0 +1,288 @@
+Metadata-Version: 2.2
+Name: ESCatastroLib
+Version: 0.0.1rc0
+Summary: Description
+Home-page: https://github.com/IvanitiX/ESCatastroLib
+Author: Iván V.R
+Author-email: IvanVR@protonmail.com
+License: Apache License, Version 2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: xml2dict
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: summary
+
+# ESCatastroLib
+
+La librería ESCatastroLib proporciona una interfaz sencilla para consultar el Catastro de España y obtener información geográfica precisa. Con esta librería, puedes acceder a datos como la ubicación de parcelas, características de construcción y valores geográficos.
+
+# Clases
+
+## Clase Municipio
+
+Representa un municipio (ciudad o pueblo).
+
+**Atributos/Inputs del constructor**
+
+`provincia (str)`: El nombre de la provincia donde se encuentra el municipio.  Un valor por
+defecto se establece y se puede proporcionar un valor diferente si es necesario.
+
+`municipio (str, opcional)`:  El nombre del municipio. Si no se proporciona al crear una instancia, se
+lanzará una excepción.  Si se especifica, debe coincidir al menos parcialmente con el nombre de un municipio válido encontrado en la base de datos o fuente de datos del sistema.
+
+**Excepciones**
+
+`Exception`: Si no se especifica el `municipio` o si es inválido, o si no corresponde a un municipio válido
+en la base de datos del sistema. Se lanzará una excepción con la lista de municipios en ese caso.
+
+## Clase Calle
+
+La clase `Calle` es una entidad que representa una calle. 
+
+**Atributos/Inputs del constructor:**
+
+`municipio (Municipio)` : Objeto que representa el Municipio al que pertenece la calle.
+
+`nombre_calle (str, opcional)` : El nombre de la calle asignada.
+
+`tipo_via (str, opcional)` : El tipo de vía de la calle asignada. Se trata de una serie de siglas que puedes consultar en `utils.listar_tipos_via()`
+
+**Excepciones**
+
+`Exception`: Si no existe la calle, o la calle tiene más de un tipo de vía. Devuelve una lista de calles en formato `TipoVia NombreCalle`
+
+## Clase ParcelaCatastral
+
+Representa una parcela catastral.
+
+
+**Inputs del constructor:**
+
+* `rc (str, opcional)`: La referencia catastral de la parcela. Por defecto es `None`. Puede ser proporcionada
+sola; también puede haber otros parámetros para buscar una parcela específica en el sistema.
+* `provincia (str, opcional)`: El nombre de la provincia. Por defecto es `None`.  Se usa para
+buscar por dirección o parcela.
+* `municipio (str, opcional)`: El nombre del municipio. Por defecto es `None`. Se usa para buscar
+por dirección o parcela.
+
+
+* `poligono (int, opcional)`: El número del polígono. Por defecto es `None` y puede ser específico para zonas rurales.
+* `parcela (int, opcional)`:  El número de la parcela. Por defecto es `None` y se usa para buscar zonas rurales.
+  
+
+
+* `tipo_via (str, opcional)`: El tipo de carretera en la dirección. Por defecto es `None` y es útil al buscar
+direcciones urbanas.
+* `calle (str, opcional)`:  El nombre de la calle en la dirección. Por defecto es `None` y es útil para
+encontrar ubicaciones urbanas
+* `numero (str, opcional)`: El número de la calle en la dirección. Por defecto es `None` y se usa para encontrar
+ubicaciones urbanas por número.
+
+**Excepciones:**
+* `ValueError`:  Si no has proporcionado suficiente información para realizar la búsqueda, o si el RC hace
+referencia a una MetaParcela.
+* `ErrorServidorCatastro`: Si hay un error con la base de datos del Catastral Server.
+
+
+**Atributos:**
+
+* `rc (str)`: La referencia catastral de la parcela.
+* `provincia (str)`:  El nombre de la provincia.
+* `municipio (str)`: El nombre del municipio.
+* `poligono (int)`:  El número del polígono. Solo se usa para terrenos rurales.
+* `parcela (int)`:  El número de la parcela. Solo se usa para terrenos rurales.
+* `tipo_via (str)`: El tipo de carretera en la dirección.
+* `calle (str)`:  El nombre de la calle en la dirección.
+* `numero (str)`:  El número de la calle en la dirección.
+* `url_croquis (str)`: La URL del croquis de la parcela.
+* `tipo (str)`: El tipo de terreno (urbano o rural).
+* `antiguedad (str)`: La edad de la parcela (solo en lotes urbanos)
+* `uso (str)`:  El uso de la parcela (solo en lotes urbanos)
+* `nombre_paraje (str)`:  El nombre del área, solo se usa para terrenos rurales.
+* `regiones (list)`: Una lista de regiones en la parcela con una descripción y superficie.
+* `geocentro (dict)`:  Las coordenadas del centro de la parcela. (Latitud y longitud)
+* `geometria (list)`:  Una lista de puntos que representan la geometría de la parcela. (Latitud y longitud)
+
+
+## Clase MetaParcela
+
+Representa una  MetaParcela, es decir, una gran parcela catastral con varias referencias catastrales (Parcels
+Catastrales más pequeñas).
+
+
+**Atributos/Inputs del constructor:**
+
+*  `rc (str|None)`: La referencia catastral de la MetaParcela. Puede ser proporcionada como `None`.
+* `provincia (str|None)`:  El nombre de la provincia donde se encuentra la MetaParcela. Por
+defecto, es `None`, lo que permite usar nombres generales.
+* `municipio (str|None)`: El nombre del municipio donde se encuentra la MetaParcela. Por
+defecto, es `None`, lo que permite usar nombres generales.
+* `poligono (int|None)`: El número del polígono en el que se encuentra la MetaParcela. Se utiliza para encontrar
+una parcela específica.
+* `parcela (int|None)`: El número de parcelas dentro de la MetaParcela. Se utiliza para encontrar una parcela
+específica.
+* `tipo_via (str|None)`: Tipo de camino en la dirección de la MetaParcela. Se usa para encontrar una parcela
+específica.
+* `calle (str|None)`: Nombre de la calle de la MetaParcela. Se usa para encontrar una parcela específica.
+* `numero (str|None)`: Número de casa de la MetaParcela.
+
+**Atributos:**
+
+* `rc (str)`: La referencia catastral de la MetaParcela.
+* `parcelas (list)`: Una lista de ParcelaCatastral que representan las parcelas que componen la MetaParcela.
+  
+
+
+# Funciones útiles
+
+## `comprobar_errores()`
+
+Comprueba si la respuesta contiene errores.
+
+**Argumentos**:
+* `respuesta (dict)`: El diccionario de respuesta.
+
+**Excepciones**:
+* El que venga de `lanzar_excepcion` (`ErrorServidorCatastro`): Si se encuentra un error en la respuesta.
+
+**Devuelve**:
+* `True` si no se encuentran errores
+
+## `listar_provincias()`
+
+Obtiene una lista de provincias.
+
+**Devuelve**:
+* `list`: Una lista de nombres de provincias.
+
+## `listar_municipios()`
+
+Obtiene una lista de municipios de España.
+
+**Argumentos**:
+* `provincia (str)`: El nombre de la provincia. Preferentemente en mayúsculas o capitalizado.
+* `municipio (str, optional)`: El nombre del municipio. Por defecto es None.
+
+**Devuelve**:
+* `List[str]`: Una lista de nombres de municipios.
+
+**Excepciones**:
+* `Exception`: Si la provincia no existe. Muestra un mensaje con las provincias disponibles.
+
+## `listar_tipos_via()`
+
+Retorna una lista de los tipos de vía disponibles.
+
+**Devuelve**:
+* `list`: Una lista de los tipos de vía disponibles.
+
+## `listar_calles()`
+
+Devuelve una lista de calles para una provincia y municipio dados.
+
+**Argumentos**:
+* `provincia (str)`: El nombre de la provincia.
+* `municipio (str)`: El nombre del municipio.
+
+**Devuelve**:
+* `list`: Una lista de calles en formato "tipo de vía nombre de vía".
+
+# Y esta librería... ¿Cómo se usa?
+¡Buena pregunta! Os dejo algunos ejemplos:
+
+```python
+from ESCatastroLib import Municipio, Calle, ParcelaCatastral, MetaParcela
+from ESCatastroLib.utils import listar_provincias, listar_tipos_via, listar_calles, listar_municipios
+
+print(listar_provincias())
+# > ['A CORUÑA', 'ALACANT', 'ALBACETE', 'ALMERIA', 'ASTURIAS', 'AVILA', 'BADAJOZ', ...]
+
+print(listar_tipos_via())
+# > {'AC': 'ACCESO', 'AG': 'AGREGADO', 'AL': 'ALDEA, ALAMEDA', 'AN': 'ANDADOR', 'AR': 'AREA, ARRABAL', 'AU': 'AUTOPISTA', 'AV': 'AVENIDA', ... }
+
+print(listar_municipios(provincia='Granada'))
+# > ['AGRON', 'ALAMEDILLA', 'ALBOLOTE', 'ALBONDON', 'ALBUÑAN', 'ALBUÑOL', 'ALBUÑUELAS', 'ALDEIRE', ...]
+
+print(listar_municipios(provincia='Granada', municipio='B'))
+# > ['ALBOLOTE', 'ALBONDON', 'ALBUÑAN', 'ALBUÑOL', 'ALBUÑUELAS', 'BAZA', 'BEAS DE GRANADA', 'BEAS DE GUADIX', ...]
+
+print(listar_calles(provincia='Granada', municipio = 'Baza'))
+# > ['CL  PARAISO (BAU)', 'CL A ALTOS', 'CL A PAVON', 'CL ABAD NAVARRO', 'PZ ABASTOS', 'CL ABEDUL', 'CL ABELARDO LOPEZ DE AYALA', 'CL ABENAMAR', 'CL ACEQUITA', 'CL ADARVE MONJAS', 'CL ADMINISTRADOR', 'TR ADUANA', 'CL ADUANA', 'CL AGUILA', 'CL AIRE', 'CL AIXA', ...]
+
+municipio = Municipio(provincia='Granada')
+# [!] Exception: Error al asignar municipio. No has especificado el municipio. Estos son los municipios disponibles: AGRON,ALAMEDILLA,ALBOLOTE,ALBONDON ...
+
+municipio = Municipio(provincia='Granada', municipio='B')
+# [!] Exception: Error al asignar municipio. No has especificado el municipio completamente. Estos son los municipios disponibles con esa búsqueda: ALBOLOTE,ALBONDON,ALBUÑAN,ALBUÑOL,ALBUÑUELAS,BAZA,BEAS DE GRANADA, ...
+
+municipio = Municipio(provincia='Granada', municipio='Baza')
+# [OK] {'provincia': 'Granada', 'municipio': 'BAZA'}
+
+calle = Calle(municipio=municipio)
+# [!] Exception: Error al asignar calle. No has especificado la calle. Estas son las calles disponibles: CL  PARAISO (BAU),CL A ALTOS,CL A PAVON,CL ABAD NAVARRO,PZ ABASTOS,CL ABEDUL,CL ABELARDO LOPEZ DE AYALA, ...
+
+calle = Calle(municipio=municipio, nombre_calle= 'M')
+# [!] Exception: Error al asignar calle. No has especificado la calle completamente, o ese nombre está en varios lados (indica el tipo de vía que aparezca al principio de la vía como PZ o CL). Estas son las calles disponibles con esa búsqueda: CL ABENAMAR,CL ADARVE MONJAS,CL ADMINISTRADOR,CL ALAMEDA,CL ALAMILLOS,CL ALAMILLOS ALTOS,CL ALAMILLOS BAJOS,CL ALAMO,CL ALGAMASILLA,CL ALHAMBRA,...
+
+calle = Calle(municipio=municipio, nombre_calle='Mayor', tipo_via='PL')
+# [!] ErrorServidorCatastro: Error del Catastro. NO HAY COINCIDENCIAS EN LA BÚSQUEDA DE VÍAS
+
+calle = Calle(municipio=municipio, nombre_calle='Mayor', tipo_via='PZ')
+# [OK] {'calle': 'MAYOR', 'tipo_via': 'PZ', 'municipio': <ESCatastroLib.models.Municipio.Municipio at 0x7f0075209e10>}
+
+pc = ParcelaCatastral(rc='22113U490470815583UK')
+# [!] ErrorServidorCatastro: Error del Catastro. NO EXISTE NINGÚN INMUEBLE CON LOS PARÁMETROS INDICADOS
+
+pc = ParcelaCatastral(rc='28067A023001490000FJ')
+# [OK] {'rc': '28067A023001490000FJ', 'url_croquis': 'https://www1.sedecatastro.gob.es/CYCBienInmueble/SECImprimirCroquisYDatos.aspx?refcat=28067A023001490000FJ', 'municipio': 'GUADALIX DE LA SIERRA', 'provincia': 'MADRID', 'tipo': 'Rústico', 'parcela': '149', 'poligono': '23', 'nombre_paraje': 'PE¥ARRUBIA', 'regiones': [{'descripcion': 'PRADOS O PRADERAS', 'superficie': '250266'}, {'descripcion': 'MONTE BAJO', 'superficie': '187652'}, {'descripcion': 'PASTOS', 'superficie': '1814'}], 'geocentro': {'x': '40.76845', 'y': '-3.672895'}, 'geometria': [{'x': '40.764879', 'y': '-3.678524'}, {'x': '40.765874', 'y': '-3.678059'}, ...], 'superficie': 439732.0}
+
+pc = ParcelaCatastral(rc='1541506VK4714B0002PK')
+# [OK] {'rc': '1541506VK4714B0002PK', 'url_croquis': 'https://www1.sedecatastro.gob.es/CYCBienInmueble/SECImprimirCroquisYDatos.aspx?refcat=1541506VK4714B0002PK', 'municipio': 'MADRID', 'provincia': 'MADRID', 'tipo': 'Urbano', 'calle': 'CL ALFONSO XII', 'numero': '34', 'antiguedad': '1915', 'uso': 'Almacen-Estacionamiento.Uso Residencial', 'regiones': [{'descripcion': 'APARCAMIENTO', 'superficie': '37'}, {'descripcion': 'ELEMENTOS COMUNES', 'superficie': '2'}], 'geocentro': {'x': '40.414193', 'y': '-3.689266'}, 'geometria': [{'x': '40.414358', 'y': '-3.689164'}, {'x': '40.414359', 'y': '-3.689094'}, {'x': '40.414288', 'y': '-3.689092'}, ...], 'superficie': 39.0}
+
+pc = ParcelaCatastral(provincia='Granada', municipio='Baza', poligono=16, parcela=128)
+# [OK] {'provincia': 'GRANADA', 'municipio': 'BAZA', 'poligono': '16', 'parcela': '128', 'rc': '18024A016001280000GY', 'url_croquis': 'https://www1.sedecatastro.gob.es/CYCBienInmueble/SECImprimirCroquisYDatos.aspx?refcat=18024A016001280000GY', 'tipo': 'Rústico', 'nombre_paraje': 'BAICO', 'regiones': [{'descripcion': 'LABOR O LABRADÍO REGADÍO', 'superficie': '14608'}], 'geocentro': {'x': '37.544352', 'y': '-2.742683'}, 'geometria': [{'x': '37.543611', 'y': '-2.74347'}, {'x': '37.543717', 'y': '-2.743522'}, {'x': '37.543945', 'y': '-2.743435'}, ...], 'superficie': 14608.0}
+
+
+pc = ParcelaCatastral(provincia='Madrid', municipio='Madrid', poligono='1', parcela='1')
+# [!] ErrorServidorCatastro: Error del Catastro. Esta parcela tiene varias referencias catastrales. Usa un objeto MetaParcela.
+
+mp = MetaParcela(provincia='Madrid', municipio='Madrid', poligono='1', parcela='1')
+# [OK] {'provincia': 'Madrid', 'municipio': 'Madrid', 'poligono': '1', 'parcela': '1', 'parcelas': [<ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7f61b2298040>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7f61b13407f0>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7f61b223a830>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7f61b223a350>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7f61b13400a0>]}
+
+pc = ParcelaCatastral(provincia='Granada', municipio='Guadix', tipo_via='CL', calle='Largacha', numero=6)
+# [!] ErrorServidorCatastro: Error del Catastro. Esta parcela tiene varias referencias catastrales. Usa un objeto MetaParcela.
+
+
+pc = ParcelaCatastral(provincia='Granada', municipio='Guadix', tipo_via='PZ', calle='Catedral', numero=1)
+# [OK] {'provincia': 'GRANADA', 'municipio': 'GUADIX', 'calle': 'PZ CATEDRAL', 'numero': '1', 'rc': '8085801VG8288E0001FA', 'url_croquis': 'https://www1.sedecatastro.gob.es/CYCBienInmueble/SECImprimirCroquisYDatos.aspx?refcat=8085801VG8288E0001FA', 'tipo': 'Urbano', 'antiguedad': '1750', 'uso': 'Religioso', 'regiones': [{'descripcion': 'RELIGIOSO', 'superficie': '3308'}], 'geocentro': {'x': '37.301262', 'y': '-3.136249'}, 'geometria': [{'x': '37.301298', 'y': '-3.136662'}, {'x': '37.301316', 'y': '-3.136699'}, {'x': '37.301376', 'y': '-3.136711'}, ...], 'superficie': 3308.0}
+
+mp = MetaParcela(provincia='Granada', municipio='Guadix', tipo_via='CL', calle='Largacha', numero=6)
+# [OK] {'provincia': 'Granada', 'municipio': 'Guadix', 'calle': 'Largacha', 'numero': 6, 'parcelas': [<ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7ff4441944c0>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7ff44507e770>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7ff444194160>, <ESCatastroLib.models.InfoCatastral.ParcelaCatastral object at 0x7ff44507e110>]}
+
+```
+
+# ¿Cómo puedo contribuir?
+Sigue las instrucciones de CONTRIBUTING.md y el Código de Conducta.
+
+# Agradecimientos
+- Al Catastro por hacer un Endpoint público.
+- A GISCE-TI por currarse [una librería similar][1], basándose en los endpoints JSON.
+- A mi abuelo y mi tío por pedirme que os eche una mano buscando tierras.
+- A [Juanlu Cano][2] por darme la idea de extender el primer concepto en la PyConES para convertirlo en esta librería.
+- A [Jaime Gómez-Obregón][3] por animar de forma muuuy indirecta a "hackear las Administraciones públicas".
+
+[1]: https://github.com/gisce/pycatastro
+[2]: https://github.com/astrojuanlu
+[3]: https://github.com/JaimeObregon

ESCatastroLib-0.0.1rc0.dist-info/RECORD

@@ -0,0 +1,14 @@
+ESCatastroLib/__init__.py,sha256=f1B_sHzinoIwapgkXv572FJbBfX5gkpyMC20JsHkKt4,143
+ESCatastroLib/models/Calle.py,sha256=Sh612v87p0Zd2Etso5j-b0TABQNSU5b8XD2JhTfEzTQ,2734
+ESCatastroLib/models/InfoCatastral.py,sha256=zkm_ep6eCQ7EM2cFPBbFEq62YDmY7SlE8x_8VYw2j6U,18075
+ESCatastroLib/models/Municipio.py,sha256=5vTGUPCM6iy703FY_xp2EjorF6XZuZY8nU2_57p-yeM,1533
+ESCatastroLib/models/__init__.py,sha256=Y8nN1Qp3_-VX7njuXwFWSq-62clHj878miEQGnzNXlc,149
+ESCatastroLib/utils/__init__.py,sha256=kQj0ORkR_JMgwWgGi73APqn3p-UQipiuMY1QaBBmkLs,106
+ESCatastroLib/utils/exceptions.py,sha256=YM3AuKHZ61SYgpmtYFz9n7JavdEOq2mLwyk2VzIol5A,759
+ESCatastroLib/utils/statics.py,sha256=jXPmMIvLexok81xPYMhlgHr4DHYu9kCwrnzFRyBAriw,3121
+ESCatastroLib/utils/utils.py,sha256=2P5w4jIIMlmR13Ev0343ZCO5Cnd5rAvsv3_kstbwHic,4358
+ESCatastroLib-0.0.1rc0.dist-info/LICENSE,sha256=kgDY5GRu9WGoKk_0F0iYmXuLmGiZ9hgtReHhCfJBWr8,11319
+ESCatastroLib-0.0.1rc0.dist-info/METADATA,sha256=i8191CJSkEI7w6NAHy_5mPQ-chs5mJ39Jg3d1H5wXbs,15695
+ESCatastroLib-0.0.1rc0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+ESCatastroLib-0.0.1rc0.dist-info/top_level.txt,sha256=_tBtZfZum8_ZkPQV72uqQIRriwkWAY56Pr_Ha-OYGRI,14
+ESCatastroLib-0.0.1rc0.dist-info/RECORD,,

ESCatastroLib-0.0.1rc0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.8.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ESCatastroLib-0.0.1rc0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ESCatastroLib