Skip to main content
POST
/
api
/
v1
/
submission
/
{pingid}
/
cat
/
acc-loc-files
Generate Acc/Loc Files
curl --request POST \
  --url https://vision.pingintel.com/api/v1/submission/{pingid}/cat/acc-loc-files \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "air_modeling_workflow_name": "<string>",
  "modeling_option_uuids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "rms_edm_name": "<string>",
  "use_ping_geocoding": true,
  "use_secondary_modifiers": true
}
'
{
  "uuid": "a1b2c3d4-0000-0000-0000-000000000001",
  "status": "pending",
  "processing_pct_complete": 50,
  "modeling_sets": [
    {
      "status": "I",
      "acc_file_url": null,
      "loc_file_url": null,
      "cat_model_type": "AIR",
      "use_secondary_modifiers": true,
      "use_ping_geocoding": false,
      "modeling_option_uuid": "a1b2c3d4-0000-0000-0000-000000000001",
      "coverate_option_uuid": "a1b2c3d4-0000-0000-0000-000000000010",
      "layer_structure_uuid": "a1b2c3d4-0000-0000-0000-000000009999",
      "layer_uuids": [
        "a1b2c3d4-0000-0000-0000-000000000101",
        "a1b2c3d4-0000-0000-0000-000000000102"
      ],
      "layer_output": "C"
    },
    {
      "status": "F",
      "acc_file_url": null,
      "loc_file_url": null,
      "cat_model_type": "AIR",
      "use_secondary_modifiers": true,
      "use_ping_geocoding": false,
      "modeling_option_uuid": "a1b2c3d4-0000-0000-0000-000000000002",
      "coverate_option_uuid": "a1b2c3d4-0000-0000-0000-000000000011",
      "layer_structure_uuid": "a1b2c3d4-0000-0000-0000-000000009999",
      "layer_uuids": [
        "a1b2c3d4-0000-0000-0000-000000000101",
        "a1b2c3d4-0000-0000-0000-000000000102"
      ],
      "layer_output": "C"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Supports Token-prefixed API keys and Bearer-prefixed JWT-based authentication.

Path Parameters

​
pingid
string
required

Ping ID of the submission.

Body

​
air_modeling_workflow_name
string | null

AIR Workflow name to use for generating acc/loc files.

​
cat_model_type
enum<string> | null

CAT model to generate files for (AIR or RMS). The submission must have configuration for the requested model via its team/division settings. If omitted, files are generated for all CAT models that are configured for the submission.

  • AIR - AIR Modeling
  • RMS - RMS Modeling
Available options:
AIR,
RMS,
null
​
layer_output
enum<string> | null

Controls how acc/loc file pairs are generated per tower. C - Combined: produces one file pair including all layers; P - Per Layer: produces a separate file pair for each layer.If omitted, configured default is used.

  • C - Combined
  • P - Per Layer
Available options:
C,
P,
null
​
modeling_option_uuids
string<uuid>[] | null

Limit generation to a specific set of modeling options. If omitted, files are generated for all modeling options on the submission.

​
rms_edm_name
string | null

RMS EDM name to use for generating acc/loc files.

​
use_ping_geocoding
boolean | null

When true, Ping-derived lat/longs are included in the generated acc/loc files. If omitted, configured default is used.

​
use_secondary_modifiers
boolean | null

When true, secondary modifiers are included in the generated acc/loc files. If omitted, configured default is used.

Response

202 - application/json
​
modeling_sets
object[]
required

Acc/Loc file pairs being generated. Each entry has its own status and may complete independently before the overall job is finished.

​
processing_pct_complete
integer
required

An integer from 0 to 100 indicating the percentage of the job that is complete. When status is C, this will be 100; when status is I, this may be 0 or some intermediate value; when status is F, this may be 0, 100, or some intermediate value depending on when the failure occurred.

​
status
enum<string>
required

N: job is not processed. I: job is in progress. C: files are ready. F: generation encountered an error.

  • N - Not Processed
  • I - In Progress
  • C - Completed
  • F - Failed
Available options:
N,
I,
C,
F
​
uuid
string<uuid>
required

Unique identifier for this generation job.