GetLocations

Devuelve todas las ubicaciones de un país: los puertos, patios, almacenes, oficinas, instalaciones de clientes y demás lugares situados bajo sus ciudades en Geo Data. Cada ubicación incluye su código, su posición, sus direcciones y sus campos de datos de ubicación. Utilícelo para hacer corresponder las ubicaciones de TrakIT con los lugares de su propio sistema.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

GET /api/v1/GetLocations?CountryCode=KE
Token: your-token

Parámetro	Obligatorio	Significado
CountryCode	Sí	El código ISO de 2 letras del país, como en Geo Data, por ejemplo KE. Las mayúsculas no importan.

Sin CountryCode, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).

Reglas

Regla	Info si no se cumple
El encabezado Token contiene un token válido.	Token missing in header, Token invalid or expired, u otra respuesta indicada en Token de inicio de sesión
El usuario es un administrador del sistema con acceso a la API.	API User must be SysAdmin with API Access
CountryCode no está vacío.	CountryCode is required

Respuesta

Si tiene éxito, RetInfo lista las ubicaciones del país, por orden de identificador, y RowsAffected indica cuántas hay. La lista incluye las ubicaciones inactivas. Las horas están en UTC, sin zona horaria (consulte Fechas y horas).

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "ID": 1204,
      "Code": "KEMBA01",
      "Name": "Mombasa - Port",
      "CityCode": "MBA",
      "Latitude": -4.067500,
      "Longitude": 39.658667,
      "LocalName": null,
      "Addr": "1 Example Road, Mombasa",
      "LocalAddr": null,
      "Disabled": false,
      "Data": []
    },
    {
      "ID": 1388,
      "Code": "KEMBA03",
      "Name": "Mombasa - Main Yard",
      "CityCode": "MBA",
      "Latitude": null,
      "Longitude": null,
      "LocalName": null,
      "Addr": null,
      "LocalAddr": null,
      "Disabled": false,
      "Data": [
        {
          "FieldName": "Opening Hours",
          "Value": "06:00-22:00",
          "ValueID": null,
          "Remarks": null,
          "Updated": "2026-10-12T09:00:21.120",
          "UpdatedBy": "JSMITH"
        }
      ]
    }
  ],
  "RowsAffected": 2,
  "Scalar": null,
  "Identity": 0
}

Las etiquetas en negrita son las de los detalles de la ubicación.

Campo	Significado
ID	El identificador de la ubicación.
Code	Code, único en todo Geo Data.
Name	Name, precedido del nombre de su ciudad, como lo muestra TrakIT en todas partes: por ejemplo Mombasa - Port.
CityCode	El código de la ciudad en la que está la ubicación.
Latitude, Longitude	La posición de la ubicación, en grados decimales, o null cuando la posición no está definida.
LocalName	Local Name, o null.
Addr, LocalAddr	Address y Local Address, o null.
Disabled	true cuando la ubicación está inactiva (Active desactivado).
Data	Los campos de datos de la ubicación que se han guardado. Una lista vacía si no hay ninguno.

Cada elemento de Data:

Campo	Significado
FieldName	El nombre del campo de datos.
Value	El valor, como texto.
ValueID	Para un campo que contiene una entidad, el identificador de la entidad; si no, null.
Remarks	Las observaciones, o null.
Updated	Cuándo se guardó el valor por última vez.
UpdatedBy	El identificador de usuario de quien lo guardó, o null para un campo calculado.

Cuando el país no tiene ubicaciones, o no existe ningún país con ese código, la respuesta tiene Code 0 e Info No locations found.

Notas

La respuesta incluye todas las ubicaciones del país con sus campos de datos, por lo que, para un país con muchas ubicaciones, puede tardar un rato. Llámelo cuando necesite actualizar su lista de ubicaciones, no antes de cada una de las demás llamadas.