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 '
{
  "modeling_option_uuids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "use_secondary_modifiers": true,
  "use_ping_geocoding": true,
  "air_modeling_workflow_name": "<string>",
  "rms_edm_name": "<string>"
}
'
{
  "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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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.

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
  • RMS - RMS
Available options:
AIR,
RMS,
null
use_secondary_modifiers
boolean | null

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

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.

layer_output
enum<string> | null

Controls how acc/loc file pairs are generated per tower. combined produces one file pair including all layers; per_layer produces a separate file pair for each layer.If omitted, configured default is used.

  • C - C
  • P - P
Available options:
C,
P,
null
air_modeling_workflow_name
string | null

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

rms_edm_name
string | null

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

Response

202 - application/json
uuid
string<uuid>
required

Unique identifier for this generation job.

status
enum<string>
required

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

  • N - N
  • I - I
  • C - C
  • F - F
Available options:
N,
I,
C,
F
processing_pct_complete
integer
required

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

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.