Ciudades disponibles
POST
Obtener la ciudad más cercana
POST /api/municipalities/get-nearest-municipality
Descripción
Identifica en qué ciudad está una persona a partir de su ubicación.
Detalles
* Compara la ubicación con el punto central de cada ciudad del país pedido y retorna la más cercana. * Si la ubicación queda lejos de todas las ciudades del país, responde sin ciudad. * La ciudad llega con su código oficial y su región, lista para buscar lugares en ella. * Es un catálogo fijo compartido por toda la plataforma y no requiere iniciar sesión.
Permisos requeridos
public
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| countryCode | string | Sí |
min:2
max:2
|
| latitude | string | Sí |
decimal
min_value:-90
max_value:90
|
| longitude | string | Sí |
decimal
min_value:-180
max_value:180
|
Respuesta
Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.
| Campo | Tipo | Descripción |
|---|---|---|
| municipality | object Admite vacío | Ciudad más cercana; vacía si la ubicación queda fuera del país |
| municipality.countryCode | string | País de la ciudad, código ISO de 2 letras |
| municipality.code | string | Código oficial de la ciudad |
| municipality.name | string | Nombre de la ciudad |
| municipality.stateRegionCode | string | Código oficial de la región |
| municipality.stateRegion | string | Nombre de la región |
Ejemplo de request
curl -X POST https://restofy.pro/api/municipalities/get-nearest-municipality \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"countryCode": "string",
"latitude": "string",
"longitude": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.