{
  "openapi": "3.0.0",
  "servers": [
    {
      "description": "Calidad",
      "url": "https://colsubsidio-test.apigee.net/api"
    },
    {
      "description": "Producción",
      "url": "https://colsubsidio-prod.apigee.net/api"
    }
  ],
  "info": {
    "description": "Información de los servicios de lo tecnologia.",
    "version": "1.0.0",
    "title": "Tecnologia localizacion",
    "termsOfService": "http://172.16.95.36/wiki/index.php/T%C3%A9rminos_de_servicio_Swagger",
    "contact": {
      "email": "operacionesti@colsubsidio.com"
    },
    "license": {
      "name": "Colsubsidio",
      "url": "http://172.16.95.36/wiki/index.php/T%C3%A9rminos_de_servicio_Swagger"
    }
  },
  "tags": [
    {
      "name": "cols-tecnologia-localizacion",
      "description": "Consulta de localizacion de una direccion."
    }
  ],
  "paths": {
    "/v1/tecnologia/localizacion": {
      "get": {
        "tags": [
          "cols-tecnologia-localizacion"
        ],
        "summary": "Consulta georeferencia",
        "description": "Obtener informacion de la ubicacion de una direccion",
        "operationId": "obtenerGeoReferencia",
        "parameters": [
          {
            "name": "codDane",
            "in": "query",
            "description": "Codigo DANE de la ciudad.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dir",
            "in": "query",
            "description": "Direccion del lugar.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Operación exitosa",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/obtenerGeoReferenciaResponse"
                }
              }
            }
          },
          "400": {
            "description": "Estado inválido"
          }
        },
        "security": [
          {
            "apigee_auth": [
              "write:apigee",
              "read:apigee"
            ]
          }
        ]
      }
    }
  },
  "externalDocs": {
    "description": "Encontrar más información en EnterpriseArchitect",
    "url": "http://172.16.95.36/wiki/index.php/Enterprise_Architect"
  },
  "components": {
    "schemas": {
      "resultado": {
        "type": "object",
        "properties": {
          "codigo": {
            "type": "string",
            "description": "Código del resultado"
          },
          "descripcion": {
            "type": "string",
            "description": "Descripción del resultado"
          }
        },
        "xml": {
          "name": "resultado"
        }
      },
      "localidad": {
        "type": "object",
        "properties": {
          "nombre": {
            "type": "string",
            "description": "Nombre de localidad."
          }
        },
        "xml": {
          "name": "localidad"
        }
      },
      "coordenadasGeograficas": {
        "type": "object",
        "properties": {
          "latitud": {
            "type": "string",
            "description": "Latitud de la direccion principal."
          },
          "longitud": {
            "type": "string",
            "description": "Longitud de la direccion principal."
          }
        },
        "xml": {
          "name": "coordenadasGeograficas"
        }
      },
      "ubicacionP": {
        "type": "object",
        "properties": {
          "tipo": {
            "type": "string",
            "description": "Tipo de ubicacion, los posibles valores son 'normal' o 'frente'."
          },
          "localidad": {
            "$ref": "#/components/schemas/localidad"
          },
          "barrio": {
            "type": "string",
            "description": "Barrio de ubicacion."
          },
          "estrato": {
            "type": "string",
            "description": "Estrato de ubicacion."
          },
          "manzana": {
            "type": "string",
            "description": "Manzana de ubicacion."
          },
          "eqmz": {
            "type": "string",
            "description": "Eqmz de ubicacion."
          },
          "zona": {
            "type": "array",
            "items": {}
          }
        },
        "xml": {
          "name": "ubicacion[0]"
        }
      },
      "direccion": {
        "type": "object",
        "properties": {
          "localidad": {
            "$ref": "#/components/schemas/localidad"
          },
          "coordenadasGeograficas": {
            "$ref": "#/components/schemas/coordenadasGeograficas"
          },
          "ubicacion": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ubicacionP"
            }
          },
          "barrioTraducido": {
            "type": "string",
            "description": "Nombre del barrio de la direccion principal."
          },
          "direccionPrincipal": {
            "type": "string",
            "description": "Direccion principal traducida."
          },
          "direccionSecundaria": {
            "type": "string",
            "description": "Direccion alterna."
          },
          "codigo": {
            "type": "string",
            "description": "Codigo de la direccion."
          },
          "codigoEncontrado": {
            "type": "string",
            "description": "Codigo encontrado de la direccion."
          }
        },
        "xml": {
          "name": "direccion"
        }
      },
      "obtenerGeoReferencia": {
        "type": "object",
        "properties": {
          "direccion": {
            "$ref": "#/components/schemas/direccion"
          },
          "estado": {
            "type": "string",
            "description": "Estado."
          },
          "fuente": {
            "type": "string",
            "description": "Fuente."
          }
        },
        "xml": {
          "name": "obtenerGeoReferencia"
        }
      },
      "obtenerGeoReferenciaResponse": {
        "type": "object",
        "required": [
          "resultado"
        ],
        "properties": {
          "resultado": {
            "type": "array",
            "xml": {
              "name": "resultado"
            },
            "items": {
              "$ref": "#/components/schemas/resultado"
            }
          },
          "obtenerGeoReferencia": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/obtenerGeoReferencia"
            }
          }
        }
      }
    },
    "requestBodies": {},
    "securitySchemes": {
      "apigee_auth": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://colsubsidio-test.apigee.net/oauth/client_credential/accesstoken?grant_type=client_credentials",
            "scopes": {
              "write:apigee": "Permisos de escritura",
              "read:apigee": "Permisos de lectura"
            }
          }
        }
      }
    }
  }
}