territory-gt

Departamentos y Municipios de Guatemala para programadores.

Los datos están actualizados hasta el 14 de diciembre de 2019.

Instalación

npm install territory-gt

Documentación

Uso

Importa el módulo usando el siguiente código:

const GT = require('territory-gt')

Departamentos

Para obtener los departamentos usa el método departamentos.

GT.departamentos();

Lo cual retornará los un String[] con los departamentos de Guatemala.

[
  'Alta Verapaz',   'Baja Verapaz',
  'Chimaltenango',  'Chiquimula',
  'El Progreso',    'Escuintla',
  'Guatemala',      'Huehuetenango',
  'Izabal',         'Jalapa',
  'Jutiapa',        'Petén',
  'Quetzaltenango', 'Quiché',
  'Retalhuleu',     'Sacatepéquez',
  'San Marcos',     'Santa Rosa',
  'Sololá',         'Suchitepéquez',
  'Totonicapán',    'Zacapa'
]

Cabeceras_Departamentales

Para obtener los departamentos usa el método cabecera.

Funciona con un parámetro, que debe ser un String con el nombre del departamento de Guatemala o devolverá undefined

Ejemplos:

GT.cabecera('Guatemala')
// 'Guatemala'

GT.cabecera('Suchitepéquez');
// 'Mazatenango'

GT.cabecera('Izabal')
// 'Puerto Barrios'

GT.cabecera('Texas')
// undefined

También puedes poner el nombre del departamento con o sin diacríticos, con o sin mayúsculas, con o sin espacios:

GT.cabecera('Suchitepéquez');
// 'Mazatenango'

GT.cabecera('suchitepequez')
// 'Mazatenango'

GT.cabecera('SuchiTePequeZ')
// 'Mazatenango'

Debes escribir el nombre completo del departamento, tal como se recibe en el metodo Departamentos sino recibirás un undefined.

GT.cabecera('Petén');
// 'Flores'

GT.cabecera('El Petén')
// undefined

Municipios

Para obtener los municipios de un departamento usa el método municipios.

Funciona con parámetro, que debe ser un String con el nombre del departamento.

El primer String será la cabecera departamental.

GT.municipios('Guatemala')}
// [
//   'Guatemala',
//   'Amatitlán',
//   'Chinautla',
//   'Chuarrancho',
//   'Fraijanes',
//   'Mixco',
//   'Palencia',
//   'San José del Golfo',
//   'San José Pinula',
//   'San Juan Sacatepequez',
//   'San Miguel Petapa',
//   'San Pedro Ayampuc',
//   'San Pedro Sacatepequez',
//   'San Raymundo',
//   'Santa Catarina Pinula',
//   'Villa Canales',
//   'Villa Nueva'
// ]

GT.municipios('Texas')
// undefined

También puede no llevar el parámetro departamentos, lo que devolverá un Objeto con todos los departamentos como parámetros. Cadá parámetro tendrá un String[] con los municipios.

GT.municipios()
// {
//   'Alta Verapaz': [
//     'Cobán',
//     'Chahal',
//     ...,
//     'Tamahú'
//  ],
//  ...,
//  Zacapa: [
//    'Zacapa',
//    'Cabañas',
//     ...,
//    'Usumatlán'
//  ]
// }

Ejemplos:

GT.municipios('Guatemala')
// 'Guatemala'

GT.municipios('Suchitepéquez');
// 'Mazatenango'

GT.municipios('Izabal')
// 'Puerto Barrios'

También puedes poner el nombre del departamento con o sin diacríticos, con o sin mayúsculas, con o sin espacios:

GT.municipios('suchitepequez')
// [
//   'Mazatenango',
//   'Chicacao',
//   ...,
//   'Zunilito'
// ]
GT.municipios('bajaVerapaz')
// [
//   'Salamá',
//   'Cubulco',
//   ...,
//   'Santa Cruz El Chol'
// ]

Debes escribir el nombre completo del departamento, tal como se recibe en el metodo Departamentos sino recibirás un undefined.

GT.municipios('Petén');
// [
//   'Flores',
//   'Dolores',
//   ...,
//   'Sayaxche'
// ]

GT.municipios('El Petén')
// undefined

Data Pura

Con este método obtendrás todos los datos de los objetos utilizados para obtener los datos.

Puedes obtener 3 datos diferntes:

• departamentos
• municipios
• municipiosObj

const datapura = GT.datapura()

datapura.municipios

// {
//   altaverapaz: [
//     'Cobán',
//     'Chahal',
//     'Chisec',
//     'Fray Bartolomé de las Casas',
//     'Lanquín',
//     'Panzos',
//     'San Cristobal Verapaz',
//     'San Miguel Tucurú',
//     'San Pedro Carchá',
//     'SanJuan Chamelco',
//     'Santa Catarina La Tinta',
//     'Santa Cruz Verapaz',
//     'Santa María Cahabón',
//     'Senahú',
//     'Tactíc',
//     'Tamahú'
//   ], [...] ,
//   zacapa: [
//     'Zacapa',     'Cabañas',
//     'Estanzuela', 'Gualán',
//     'Huité',      'La Unión',
//     'Río Hondo',  'San Diego',
//     'Teculután',  'Usumatlán'
//   ]
// }