La cascada: zones1 / zones2 / zones3

Son tres endpoints que devuelven las mismas zonas que la lista completa, pero de a un nivel:

zones1  →  las provincias/estados de un país
zones2  →  los partidos/municipios de una provincia
zones3  →  las localidades/barrios de un partido

Sirven para resolver una rama puntual sin bajarte las miles de filas del país. Si lo que estás haciendo es mapear tu catálogo entero, usá la lista completa: es una llamada por cada mil zonas en vez de una por cada rama.

1 · Provincias de un país

GET https://mapaprop.app/api/action/property-catalog-v1/zones1?country=AR

[
  { "zone0": 1, "zone1": 2, "description": "Buenos Aires" },
  { "zone0": 1, "zone1": 1, "description": "Capital Federal" }
]

2 · Partidos de una provincia

GET https://mapaprop.app/api/action/property-catalog-v1/zones2?country=AR&zone1=1

[
  { "zone0": 1, "zone1": 1, "zone2": 1340, "description": "Abasto", "code": "1-1-1340-0" }
]

Acá sí viene code: cada partido ya es una zona publicable por sí misma. Si sabés el partido y no la localidad, este código te alcanza.

3 · Localidades de un partido

GET https://mapaprop.app/api/action/property-catalog-v1/zones3?country=AR&zone1=2&zone2=201

[
  { "zone0": 1, "zone1": 2, "zone2": 201, "zone3": 117,
    "description": "Aldo Bonzi", "code": "1-2-201-117" }
]

Una lista vacía acá no es un error: significa que ese partido no tiene localidades debajo y que el código publicable es el del partido (zone2 con -0). Pasa con todos los barrios porteños, por ejemplo.

Errores

Ver también

• Zonas — el concepto y el formato del código
• La lista completa — para mapear tu catálogo en lote