Consulta de Maestros Localidades
Consulta de Maestros Localidades
Servicio de Consulta de Maestro Localidades (catalog level4query)
El cliente debe enviar una estructura de datos debiendo completar mínimamente los campos que se detallan a continuación:
- level1: Prefijo de país (AR)
- level2: Deberá completarse con la provincia
- level4: Deberá completarse con la localidad que se desea buscar
- clientAccessCode: ID de acceso de cliente
Los siguientes campos son los Headers Obligatorios que deben informarse:
- Authorization: Header con el ID de acceso de cliente (ClientAccessCode)
- Content-Type: Header que se informa el tipo de contenido del mensaje, se debe informar application/json
Método: POST
Endpoint: https://ws.merlindataquality.com/catalog/level4query
Parámetros de llamada
| Parámetro | Descripción | Longitud | Tipo |
| Authorization | Identificador único de usuarios. Este valor identifica y valida en cada invocación a un usuario determinado. Este valor tiene asociado los roles que le corresponden al usuario. | 64 | String |
| Content-Type | Header que se informa el tipo de contenido del mensaje, se debe informar application/json. | String | |
| level1 | Corresponde al primer nivel (País) administrativo de una dirección. | 2 | String |
| level2 | Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. | 64 | String |
| level4 | Se ingresa la localidad o parte de la misma que se desea buscar. | 64 | String |
Mensaje JSON de petición
{
"level1": "AR",
"level2": "",
"level4": "lauquen"
}Respuesta
La respuesta está compuesta por una lista de elementos que tienen la siguiente estructura:
| Parámetro | Descripción | Longitud | Tipo |
| status | Indica el estado de normalización y/o validación. | 2 | String |
| statusReason | Indica la razón con referencia al estado de normalización y/o validación. | 2 | String |
| transactionId | Merlin asigna un id de transacción por consulta. | 40 | String |
| mSuggest | Son los datos de nombre normalizado.. | – | – |
| id | Id del tramo ubicado | 64 | String |
| name | Indica la localidad que se sugiere. | 64 | String |
| desc | indica una descripción de la localidad. | 64 | String |
| synonymous | Informa algún sinónimo que posee la Localidad. | 64 | String |
| relieved | Informa si la localidad se encuentra Relevada. | 4 | Boolean |
| x | Coordenada X de georeferenciación. | 10 | String |
| y | Coordenada Y de georeferenciación. | 10 | String |
Mensaje JSON de respuesta
{
"status": "CO",
"statusReason": "SM",
"transactionId": "7e38d167-8a5c-4e60-b693-7d1ac0472046",
"mSuggest": [
{
"id": 1034,
"name": "BERISSO",
"desc": "BERISSO",
"synonymous": "NN",
"relieved": true,
"x": "-57.819527",
"y": "-34.902846"
}
]
}