--- title: "GET /udl/emittergeolocation" method: GET path: "/udl/emittergeolocation" tags: ["Report and Activity"] --- # GET /udl/emittergeolocation `GET /udl/emittergeolocation` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/emittergeolocation` - Auth: none declared Service operation to dynamically query data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (`/udl//queryhelp`) for more details on valid/required query parameter information. ## Query parameters - `startTime` string, date-time, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - EmitterGeoLocationAbridged[] - `id` string: Unique identifier of the record, auto-generated by the system. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `signalOfInterestType` string, required: Type of the signal of interest of this Emitter Geo Location (e.g. RF). - `orderId` string: The order identifier for this Emitter Geo Location data set. - `createdTs` string, date-time: Specifies the creation time associated with the order in ISO 8601 UTC with microsecond precision. - `receivedTs` string, date-time: The time representing the mean of the constituent single-burst observations in ISO 8601 UTC with microsecond precision. - `startTime` string, date-time, required: The start time for this Emitter Geo Location data set in ISO 8601 UTC with microsecond precision. - `endTime` string, date-time: The end time for this Emitter Geo Location data set in ISO 8601 UTC with microsecond precision. - `idOnOrbit` string: Unique identifier of the satellite used to identify and geolocate Emitter signals of interest. This ID can be used to obtain additional information on an OnOrbit object using the 'get by ID' operation (e.g. /udl/onorbit/{id}). For example, the onorbit object with idOnOrbit = abc would be queried as /udl/onorbit/abc. Used when Emitter geolocation is done by a single satellite. - `satNo` integer: Satellite/catalog number of the on-orbit spacecraft used to identify and geolocate Emitter signals of interest of this detection. Used when Emitter geolocation is done by a single satellite. - `origObjectId` string: Optional identifier of the satellite used to identify and geolocate Emitter signals of interest of this observation. This may be an internal identifier and not necessarily a valid satellite number. Used when Emitter geolocation is done by a single satellite. - `idSensor` string: Unique identifier of the reporting sensor. This ID can be used to obtain additional information on a sensor using the 'get by ID' operation (e.g. /udl/sensor/{id}). For example, the sensor with idSensor = abc would be queried as /udl/sensor/abc. Used when Emitter geolocation is done by a single sensor. - `origSensorId` string: Optional identifier provided by observation source to indicate the sensor identifier which produced this Emitter Geo Location. This may be an internal identifier and not necessarily a valid sensor ID. Used when Emitter geolocation is done by a single sensor. - `cluster` string: The name(s) of the subset of constellation spacecraft that made this detection. - `constellation` string: The name of the satellite constellation. - `signalOfInterest` string: The name of the signal of interest. - `idRFEmitter` string: Optional identifier of the geolocated signal of interest RF Emitter for this observation. This ID can be used to obtain additional information on an RF Emitter object using the 'get by ID' operation (e.g. /udl/rfemitter/{id}). For example, the rfemitter object with idRFEmitter = abc would be queried as /udl/rfemitter/abc. - `origRFEmitterId` string: Optional identifier of the emitter of interest for this observation. This may be an internal identifier and not necessarily a valid emitter Id. - `numBursts` integer: The count of single-burst observations used for this geolocation observation. - `minFreq` number, double: The minimum detected frequency in megahertz. - `maxFreq` number, double: The maximum detected frequency in megahertz. - `centerFreq` number, double: The detected signal frequency in megahertz. - `minPRI` number, double: Minimum pulse repetition interval of the emitter, measured in microseconds. The interval between the start of one pulse and the start of another. - `maxPRI` number, double: Maximum pulse repetition interval of the emitter, measured in microseconds. The interval between the start of one pulse and the start of another. - `avgPRI` number, double: Average pulse repetition interval of the emitter, measured in microseconds. The interval between the start of one pulse and the start of another. - `minPRF` number, double: Minimum pulse repetition frequency of the emitter, measured in hertz. PRF is the number of pulses transmitted per second. This is the reciprocal of the maxPRI (Pulse Repetition Interval) value. - `maxPRF` number, double: Maximum pulse repetition frequency of the emitter, measured in hertz. PRF is the number of pulses transmitted per second. This is the reciprocal of the minPRI (Pulse Repetition Interval) value. - `avgPRF` number, double: Average pulse repetition frequency of the emitter, measured in hertz. PRF is the number of pulses transmitted per second. This is the reciprocal of the avgPRI (Pulse Repetition Interval) value. - `minPW` number, double: Minimum pulse width of the emitter, measured in nanoseconds. This is the minimum duration of the pulse. - `maxPW` number, double: Maximum pulse width of the emitter, measured in nanoseconds. This is the maximum duration of the pulse. - `avgPW` number, double: Average pulse width of the emitter, measured in nanoseconds. This is the average duration of the pulse. - `pulseShape` string: Describes the form of the emitted pulse and how its signal varies within the pulse duration (e.g. GAUSSIAN, RECTANGULAR, TRAPEZOIDAL, etc.). - `detectLat` number, double: WGS-84 latitude of the most likely emitter location coordinate point, in degrees. -90 to 90 degrees (negative values south of equator). - `detectLon` number, double: WGS-84 longitude of the most likely emitter location coordinate point, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `detectAlt` number, double: The altitude relative to WGS-84 ellipsoid, in meters. - `errEllp` number[]: Confidence ellipsoid about the detection location [semi-major axis (meters), semi-minor axis (meters), orientation (degrees) measured clockwise (0-360 from true north)]. - `confArea` number, double: The area of the confidence ellipse specified in meters squared to contain the emitter with a 95% probability. - `atype` string: Type of region as projected on the ground. - `agjson` string: Geographical region or polygon (lat/lon pairs), as depicted by the GeoJSON representation of the geometry/geography, of the image as projected on the ground. GeoJSON Reference: https://geojson.org/. Ignored if included with a POST or PUT request that also specifies a valid 'area' or 'atext' field. - `atext` string: Geographical region or polygon (lon/lat pairs), as depicted by the Well-Known Text representation of the geometry/geography, of the image as projected on the ground. WKT reference: https://www.opengeospatial.org/standards/wkt-crs. Ignored if included with a POST or PUT request that also specifies a valid 'area' field. - `andims` integer: Number of dimensions of the geometry depicted by region. - `asrid` integer: Geographical spatial_ref_sys for region. - `passGroupId` string: Optional external identifier referencing the entity used in the calculation of the geolocation. - `algVersion` string: The EmitterGeo algorithm type and version used in Emitter geolocation calculations. - `externalId` string: Optional ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `tags` string[]: Optional array of provider/source specific tags for this data, where each element is no longer than 32 characters, used for implementing data owner conditional access controls to restrict access to the data. Should be left null by data providers unless conditional access controls are coordinated with the UDL team. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `source` string, required: Source of the data. - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `sourceDL` string: The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL. - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2026-03-25** `173e4aff893f`: 1 breaking - the `items/errEllp` response property's minItems was decreased from `3` to `0` for the response status `200` - **2025-10-23** `09bd422d5ac1`: 10 info - added the optional property `items/avgPRF` to the response with the `200` status - added the optional property `items/avgPRI` to the response with the `200` status - added the optional property `items/avgPW` to the response with the `200` status - added the optional property `items/maxPRF` to the response with the `200` status - …6 more - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/emittergeolocation/get.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)