# Zonas

❗️ Nota

Los llamados a la API de esta sección tambien soportan las variables quantity (booleana), id_property_type (ver Tipos de propiedad), for_sale (booleana), for_rent (booleana), for_transfer (booleana) y scope (número), para ver un ejemplo de ello, visita la sección Países.

Para obtener información todas las zonas de una ciudad en especifico conociendo su id contamos con la URI general:

api.wasi.co/v1/location/zones-from-city/#id_city

Por ejemplo para Armenia el id_city es 63, entonces la URI seria:

api.wasi.co/v1/location/zones-from-city/794

Esto debería retornar un JSON con las zonas que se hayan ingresado como este:

{
    "0": {
        "id_zone": "1",
        "name": "Norte",
        "id_city": "63",
        "id_location": 0,
        "owner": "own"
    },
    "1": {
        "id_zone": "2",
        "name": "Sur",
        "id_city": "63",
        "id_location": 0,
        "owner": "own"
    },
    "2": {
        "id_zone": "3",
        "name": "Centro",
        "id_city": "63",
        "owner": "own"
    },
    "3": {
        "id_zone": "3",
        "name": "Centro",
        "id_city": "63",
        "id_location": 0,
        "owner": "allied"
    },
    "status": "success"
}

❗️ Importante

Con este llamado solo saldrian las zonas que no esten asociadas a una Localidad.

En el caso de las zonas que estén asociadas a una Localidad, se pueden obtener todas las zonas en especifico conociendo su id, contamos con la URI general:

api.wasi.co/v1/location/zones-from-location/#id_location

Por ejemplo para Chapinero el id_location es 2, entonces la URI seria:

api.wasi.co/v1/location/zones-from-location/2

Esto debería retornar un JSON con las zonas que se hayan ingresado como este:

{
    "0": {
        "id_zone": "137805",
        "name": "Refugio",
        "id_city": 794,
        "id_location": 2,
        "owner": "standar"
    },
    "1": {
        "id_zone": "137806",
        "name": "San Isidro",
        "id_city": 794,
        "id_location": 2,
        "owner": "own"
    },
    "status": "success"
}

El campo owner en el JSON de respuesta indica si la propiedad obtenida es propia (own), de una empresa aliada (allied) o propia de Wasi (standar).

Adicionalmente para las Zonas la variable scope se usa para filtrar las zonas privadas o de los aliados en el listado de zonas. Por defecto, si no se envia esta variable se listan todas las zonas. El campo owner en el JSON de respuesta indica si la zona obtenida es propia (own) o de una empresa aliada (allied).

Valor Representa
1 Privado, sólo zonas creadas por la empresa. (opción por defecto)
2 Aliados, sólo zonas asignadas a las propiedades activas de empresas aliadas.
3 Privados y Aliado, todas las zonas.

Como las zonas son editables por el usuario, puede ocurrir que hayan varias zonas con el mismo nombre, en ese caso se puede enviar el parametro distinct con valor true para que las zonas sean agrupadas por nombre, los identificadores quedan separados por coma en el campo id_zone.

Por ejemplo si para la ciudad 1 existen varias zonas con el nombre Zona centro, entonces la URI seria:

api.wasi.co/v1/location/zones-from-city/1?distinct=true

Esto debería retornar un JSON con las zonas como este:

{
    "0": {
        "id_zone": "1,4",
        "name": "Zona centro",
        "id_city": 1,
        "id_location": 0,
        "owner": ""
    },
    "1": {
        "id_zone": "2",
        "name": "Zona norte",
        "id_city": 1,
        "id_location": 0,
        "owner": "standar"
    },
}

❗️ Importante

Las zonas son gestionadas desde Wasi.co, si no se han ingresado Zonas el JSON solo tendra el status success.

Para obtener información de una zona en especifico conociendo su id se tiene la URI general:

api.wasi.co/v1/location/zone/#id_zone

Para una zona de ejemplo llamada Norte el id_zone es 1, entonces la URI seria:

api.wasi.co/v1/location/zone/1

Y se obtiene la respuesta:

{
    "id_zone": "1",
    "name": "Norte",
    "id_city": "63",
    "id_location": "0",
    "status": "success"
}

❗️ Importante

Para todas las peticiones es necesario el envío de credenciales, para más información puedes visitar la sección de Primeros pasos.

❗️ Note

Es posible crear una nueva zona enviando el campo zone como texto al agregar o actualizar una propiedad como se indica en Campos de las propiedades.

Last Updated: 8/3/2020, 9:51:52 PM