| Name | geofaker JSON |
| Version |
1.1
JSON |
| download |
| home_page | https://github.com/LuiisDev21/GeoFaker |
| Summary | Libreria que te proporciona direcciones reales de Estados Unidos |
| upload_time | 2025-08-11 01:47:49 |
| maintainer | None |
| docs_url | None |
| author | LuiisDev21 |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# GeoFaker
GeoFaker is a Python library designed to work with real-world addresses selected from public datasets, verified using geocoding services such as the Google Maps API. Its purpose is to provide authentic address data that resolves correctly when geocoded, making it ideal for testing, simulations, or demonstrations that require realistic locations without compromising personal information.
In addition to real addresses, GeoFaker also generates complementary random data such as names, phone numbers, email addresses, and other typical profile details—allowing you to create richer, more realistic datasets for development or testing environments involving fictitious but coherent personal information.
## Installation
You can install GeoFaker using pip:
```sh
pip install GeoFaker
```
## Usage
```python
from GeoFaker import XMap
# Load new instance ./utils, defs....
def XmapNewInstance():
try:
XMap.LoadMap()
return {
"street": XMap.GetMap("address1"),
"city": XMap.GetMap("city"),
"state": XMap.GetMap("state"),
"stid": XMap.GetMap("StateCode"),
"zipp": XMap.GetMap("PostalCode"),
"num": XMap.GetMap("Phone"),
"usuario": XMap.GetMap("User"),
"password": XMap.GetMap("Pass"),
"mail": XMap.GetMap("Mail"),
"name": XMap.GetMap("Fname"),
"last": XMap.GetMap("Lname"),
}
except Exception as e:
print(f"Error loading XMap data: {e}")
return None
# Use in your proyect
try:
NewMap = XmapNewInstance()
street = NewMap['street']
city = NewMap['city']
stid = NewMap['stid']
zipp = NewMap['zipp']
state = NewMap['state']
num = NewMap['num']
usuario = NewMap['usuario']
password = NewMap['password']
mail = NewMap['mail']
name = NewMap['name']
last = NewMap['last']
except Exception as u:
print(f"Error getting Xmap data: {e}")
return None
```
## Project Structure
```
GeoFaker/
__init__.py
Func.py
data/
usa.json
README.md
setup.py
```
- `Func.py`: Main logic of the `XMap` class.
- `data/usa.json`: US address dataset.
- `setup.py`: Installation script.
- `README.md`: This file.
## Requirements
- Python >= 3.10
- [names](https://pypi.org/project/names/)
- Json
---
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# GeoFaker
GeoFaker es una librería de Python diseñada para trabajar con direcciones reales seleccionadas a partir de conjuntos de datos públicos, verificadas mediante servicios de geocodificación como la API de Google Maps. Su propósito es ofrecer datos de direcciones auténticas que se resuelven correctamente al ser geocodificadas, lo que resulta útil para pruebas, simulaciones o demostraciones que requieran ubicaciones verídicas sin comprometer datos personales.
Además de direcciones reales, GeoFaker también genera datos aleatorios complementarios como nombres, números de teléfono, direcciones de correo electrónico y otros detalles típicos de perfiles, permitiendo crear conjuntos de datos más completos y realistas para entornos de desarrollo o pruebas de sistemas que manejen información personal ficticia pero coherente.
## Instalación
Puedes instalar GeoFaker usando pip:
```sh
pip install GeoFaker
```
## Uso
```python
from GeoFaker import XMap
# Cargar una nueva instancia ./utils, defs....
def XmapNewInstance():
try:
XMap.LoadMap()
return {
"street": XMap.GetMap("address1"),
"city": XMap.GetMap("city"),
"state": XMap.GetMap("state"),
"stid": XMap.GetMap("StateCode"),
"zipp": XMap.GetMap("PostalCode"),
"num": XMap.GetMap("Phone"),
"usuario": XMap.GetMap("User"),
"password": XMap.GetMap("Pass"),
"mail": XMap.GetMap("Mail"),
"name": XMap.GetMap("Fname"),
"last": XMap.GetMap("Lname"),
}
except Exception as e:
print(f"Error loading XMap data: {e}")
return None
# Uso en tu proyecto
try:
NewMap = XmapNewInstance()
street = NewMap['street']
city = NewMap['city']
stid = NewMap['stid']
zipp = NewMap['zipp']
state = NewMap['state']
num = NewMap['num']
usuario = NewMap['usuario']
password = NewMap['password']
mail = NewMap['mail']
name = NewMap['name']
last = NewMap['last']
except Exception as u:
print(f"Error getting Xmap data: {e}")
return None
```
## Estructura del Proyecto
```
GeoFaker/
__init__.py
Func.py
data/
usa.json
README.md
setup.py
```
- `Func.py`: Lógica principal de la clase `XMap`.
- `data/usa.json`: Dataset de direcciones de EE.UU.
- `setup.py`: Script de instalación.
- `README.md`: Este archivo.
## Requisitos
- Python >= 3.10
- [names](https://pypi.org/project/names/)
- Json
---
Raw data
{
"_id": null,
"home_page": "https://github.com/LuiisDev21/GeoFaker",
"name": "geofaker",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "LuiisDev21",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/8b/8c/31669e9f401e4255530d18c15b5222f96e8dc097198e663c1759ef77264d/geofaker-1.1.tar.gz",
"platform": null,
"description": "# GeoFaker\r\n\r\nGeoFaker is a Python library designed to work with real-world addresses selected from public datasets, verified using geocoding services such as the Google Maps API. Its purpose is to provide authentic address data that resolves correctly when geocoded, making it ideal for testing, simulations, or demonstrations that require realistic locations without compromising personal information.\r\n\r\nIn addition to real addresses, GeoFaker also generates complementary random data such as names, phone numbers, email addresses, and other typical profile details\u2014allowing you to create richer, more realistic datasets for development or testing environments involving fictitious but coherent personal information.\r\n\r\n## Installation\r\n\r\nYou can install GeoFaker using pip:\r\n\r\n```sh\r\npip install GeoFaker\r\n```\r\n\r\n## Usage\r\n\r\n```python\r\nfrom GeoFaker import XMap\r\n\r\n# Load new instance ./utils, defs....\r\ndef XmapNewInstance():\r\n try:\r\n XMap.LoadMap()\r\n return {\r\n \"street\": XMap.GetMap(\"address1\"),\r\n \"city\": XMap.GetMap(\"city\"),\r\n \"state\": XMap.GetMap(\"state\"),\r\n \"stid\": XMap.GetMap(\"StateCode\"),\r\n \"zipp\": XMap.GetMap(\"PostalCode\"),\r\n \"num\": XMap.GetMap(\"Phone\"),\r\n \"usuario\": XMap.GetMap(\"User\"),\r\n \"password\": XMap.GetMap(\"Pass\"),\r\n \"mail\": XMap.GetMap(\"Mail\"),\r\n \"name\": XMap.GetMap(\"Fname\"),\r\n \"last\": XMap.GetMap(\"Lname\"),\r\n }\r\n except Exception as e:\r\n print(f\"Error loading XMap data: {e}\")\r\n return None\r\n\r\n\r\n# Use in your proyect\r\ntry: \r\n NewMap = XmapNewInstance()\r\n street = NewMap['street']\r\n city = NewMap['city']\r\n stid = NewMap['stid']\r\n zipp = NewMap['zipp']\r\n state = NewMap['state']\r\n num = NewMap['num']\r\n usuario = NewMap['usuario']\r\n password = NewMap['password']\r\n mail = NewMap['mail']\r\n name = NewMap['name']\r\n last = NewMap['last']\r\nexcept Exception as u:\r\n print(f\"Error getting Xmap data: {e}\")\r\n return None\r\n\r\n```\r\n\r\n## Project Structure\r\n\r\n```\r\nGeoFaker/\r\n __init__.py\r\n Func.py\r\n data/\r\n usa.json\r\nREADME.md\r\nsetup.py\r\n```\r\n\r\n- `Func.py`: Main logic of the `XMap` class.\r\n- `data/usa.json`: US address dataset.\r\n- `setup.py`: Installation script.\r\n- `README.md`: This file.\r\n\r\n## Requirements\r\n\r\n- Python >= 3.10\r\n- [names](https://pypi.org/project/names/)\r\n- Json\r\n\r\n---\r\n\r\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\r\n\r\n# GeoFaker\r\n\r\nGeoFaker es una librer\u00eda de Python dise\u00f1ada para trabajar con direcciones reales seleccionadas a partir de conjuntos de datos p\u00fablicos, verificadas mediante servicios de geocodificaci\u00f3n como la API de Google Maps. Su prop\u00f3sito es ofrecer datos de direcciones aut\u00e9nticas que se resuelven correctamente al ser geocodificadas, lo que resulta \u00fatil para pruebas, simulaciones o demostraciones que requieran ubicaciones ver\u00eddicas sin comprometer datos personales.\r\n\r\nAdem\u00e1s de direcciones reales, GeoFaker tambi\u00e9n genera datos aleatorios complementarios como nombres, n\u00fameros de tel\u00e9fono, direcciones de correo electr\u00f3nico y otros detalles t\u00edpicos de perfiles, permitiendo crear conjuntos de datos m\u00e1s completos y realistas para entornos de desarrollo o pruebas de sistemas que manejen informaci\u00f3n personal ficticia pero coherente.\r\n\r\n## Instalaci\u00f3n\r\n\r\nPuedes instalar GeoFaker usando pip:\r\n\r\n```sh\r\npip install GeoFaker\r\n```\r\n\r\n## Uso\r\n\r\n```python\r\nfrom GeoFaker import XMap\r\n\r\n# Cargar una nueva instancia ./utils, defs....\r\ndef XmapNewInstance():\r\n try:\r\n XMap.LoadMap()\r\n return {\r\n \"street\": XMap.GetMap(\"address1\"),\r\n \"city\": XMap.GetMap(\"city\"),\r\n \"state\": XMap.GetMap(\"state\"),\r\n \"stid\": XMap.GetMap(\"StateCode\"),\r\n \"zipp\": XMap.GetMap(\"PostalCode\"),\r\n \"num\": XMap.GetMap(\"Phone\"),\r\n \"usuario\": XMap.GetMap(\"User\"),\r\n \"password\": XMap.GetMap(\"Pass\"),\r\n \"mail\": XMap.GetMap(\"Mail\"),\r\n \"name\": XMap.GetMap(\"Fname\"),\r\n \"last\": XMap.GetMap(\"Lname\"),\r\n }\r\n except Exception as e:\r\n print(f\"Error loading XMap data: {e}\")\r\n return None\r\n\r\n\r\n# Uso en tu proyecto\r\ntry: \r\n NewMap = XmapNewInstance()\r\n street = NewMap['street']\r\n city = NewMap['city']\r\n stid = NewMap['stid']\r\n zipp = NewMap['zipp']\r\n state = NewMap['state']\r\n num = NewMap['num']\r\n usuario = NewMap['usuario']\r\n password = NewMap['password']\r\n mail = NewMap['mail']\r\n name = NewMap['name']\r\n last = NewMap['last']\r\nexcept Exception as u:\r\n print(f\"Error getting Xmap data: {e}\")\r\n return None\r\n\r\n```\r\n\r\n## Estructura del Proyecto\r\n\r\n```\r\nGeoFaker/\r\n __init__.py\r\n Func.py\r\n data/\r\n usa.json\r\nREADME.md\r\nsetup.py\r\n```\r\n\r\n- `Func.py`: L\u00f3gica principal de la clase `XMap`.\r\n- `data/usa.json`: Dataset de direcciones de EE.UU.\r\n- `setup.py`: Script de instalaci\u00f3n.\r\n- `README.md`: Este archivo.\r\n\r\n## Requisitos\r\n\r\n- Python >= 3.10\r\n- [names](https://pypi.org/project/names/)\r\n- Json\r\n\r\n---\r\n\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Libreria que te proporciona direcciones reales de Estados Unidos",
"version": "1.1",
"project_urls": {
"Homepage": "https://github.com/LuiisDev21/GeoFaker"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e14e9572198a71ec66baaa555e304071188a667432e31fac2d915575e40ecded",
"md5": "c9ec3d389cca801700b5a66e8f6ea449",
"sha256": "17863385bc754d02bdf082dddfbbe98abd235ca0e3d565ef6970adff587d14d9"
},
"downloads": -1,
"filename": "geofaker-1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c9ec3d389cca801700b5a66e8f6ea449",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 108831,
"upload_time": "2025-08-11T01:47:48",
"upload_time_iso_8601": "2025-08-11T01:47:48.698914Z",
"url": "https://files.pythonhosted.org/packages/e1/4e/9572198a71ec66baaa555e304071188a667432e31fac2d915575e40ecded/geofaker-1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8b8c31669e9f401e4255530d18c15b5222f96e8dc097198e663c1759ef77264d",
"md5": "3b1d3480d47263998bb98be0def5febe",
"sha256": "8d1253dcea82c0b4d2117437ce13019208fb622558739f438ea1150014526027"
},
"downloads": -1,
"filename": "geofaker-1.1.tar.gz",
"has_sig": false,
"md5_digest": "3b1d3480d47263998bb98be0def5febe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 103407,
"upload_time": "2025-08-11T01:47:49",
"upload_time_iso_8601": "2025-08-11T01:47:49.898886Z",
"url": "https://files.pythonhosted.org/packages/8b/8c/31669e9f401e4255530d18c15b5222f96e8dc097198e663c1759ef77264d/geofaker-1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-11 01:47:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "LuiisDev21",
"github_project": "GeoFaker",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "geofaker"
}
