Location miscellaneous validation rules for feature compatibility and configuration requirements

OrgIsRejected

Preconditions
orgId resolves to organization that is location owner

Definition	Severity	API	Sample	Mode
Validate that orgId does not resolve to an organization that is REJECTED or if more information has been requested from the organization (REQUEST_FOR_INFO)

Example Validation Report

{
  "code": "VALIDATION__OrgIsRejected",
  "message": "Organization must not be rejected",
  "severity": "VIOLATION"
}

OrgIsNotVerified

Preconditions
orgId resolves to organization that is a third-party partner, not location owner

Definition	Severity	API	Sample	Mode
Validate that orgId resolves to organization that is verified

CountOfAgencyLocationsExceedsThreshold

Preconditions
Exclude DELETED resources
Organization resolves to third-party partner, not location owner
Organization is portal user only. (No API access)

Definition	Severity	API	Sample	Mode
Validate that the count of organization locations does not exceed one hundred thousand (100,000)

note

Only an approved (verified) agency is permitted to manage locations

Example Validation Report

{
  "code": "VALIDATION__CountOfAgencyLocationsExceedsThreshold",
  "message": "Count of locations cannot exceed one hundred thousand (100,000)",
  "severity": "VIOLATION"
}

CountOfUnverifiedOwnerLocationsExceedsThreshold

Preconditions
Exclude DELETED resources
Organization type is OWNER

Definition	Severity	API	Sample	Mode
Validate that the count of unverified organization locations does not exceed one hundred (100)

Example Validation Report

{
  "code": "VALIDATION__CountOfUnverifiedOwnerLocationsExceedsThreshold",
  "message": "Count of locations cannot exceed one hundred (100)",
  "severity": "VIOLATION"
}

CountOfVerifiedOwnerLocationsExceedsThreshold

Preconditions
Exclude DELETED resources
orgId resolves to organization that is a third-party partner, not location owner

Definition	Severity	API	Sample	Mode
Validate that the count of verified organization locations does not exceed one hundred thousand (100,000)

Example Validation Report

{
  "code": "VALIDATION__CountOfVerifiedOwnerLocationsExceedsThreshold",
  "message": "Count of locations cannot exceed one hundred thousand (100,000)",
  "severity": "VIOLATION"
}

LocationExcluded

Definition	Severity	API	Sample	Mode
Validate that a location resource is eligible to participate in conflation

Example Validation Report

{
  "code": "VALIDATION__LocationExcluded",
  "message": "Location not published for reason '{{reason}}'",
  "severity": "VIOLATION",
  "context": {
    "reason": "VENDOR_PLACE_IGNORED",
    "id": "1563008884544638590"
  }
}

PoiSuppressedInAppleMaps

Definition	Severity	Sample Input	Reference	Mode
Validate that a POI is not suppressed in Apple Maps	VIOLATION			o

Example Validation Report

{
  "code": "VALIDATION__PoiSuppressedInAppleMaps",
  "message": "POI suppressed in Apple Maps for '{{reason}}'. Location will not be published while POI remains suppressed",
  "severity": "VIOLATION",
  "context": {
    "reason": "SUPPRESSED_NAME"
  },
  "details": {
    "compared": [],
    "expected": [],
    "submitted": [],
    "createdDate": "2026-03-23T15:48:48.596Z"
  }
}

Reason Codes

{{reason}} any of	Description
SUPPRESSED_DISPUTED	POI is contained by disputed territory or unsupported region.
SUPPRESSED_EVERYWHERE	POI must not be displayed on client.
SUPPRESSED_NAME	POI legitimately has no name.
SUPPRESSED_SHELL	POI no longer has data. Validation report may be followed or preceded by generation of PROCESSING__LocationPlaceCardURLChanged code

note

In addition, metadata is associated with the location resource.

Confidence Level

ConfidenceLevelMustBeWithinValidRange

Definition	Severity	API	Sample	Mode
Validate that the confidenceLevel value is within a valid range			Link

Geometry

GeometryCoordinatesMustBeSufficientlyPrecise

Definition	Severity	API	Sample	Mode
Validate that latitude and longitude values possess minimum precision (5 decimal places)			Link

GeometryLatLongMustNotBeZero

Definition	Severity	API	Sample	Mode
Validates that values of latitude and longitude are not both zero

GeometryMustHaveValidFormat

Definition	Severity	API	Sample	Mode
Validate that geometry has valid formatting

GeometryMustNotBeEmpty

Definition	Severity	API	Sample	Mode
Validate that geometry is not an empty string

WkbGeometryMustBeAnAcceptedType

Definition	Severity	API	Sample	Mode
Validate that geometry is an accepted type

Location

UndeleteOperationNotSupported

Definition	Severity	API	Sample	Mode
Validate that the location was deleted less than 90 days ago

Example Validation Report

{
  "code": "VALIDATION__UndeleteOperationNotSupported",
  "message": "Undelete operation is not supported for locations that have been deleted 90 days ago or more",
  "severity": "VIOLATION"
}

UndeleteOperationNotSupportedForOrgType

Definition	Severity	API	Sample	Mode
Validate that orgId resolves to third-party partner. (Not location owner or unverified agency)

Example Validation Report

{
  "code": "VALIDATION__UndeleteOperationNotSupportedForOrgType",
  "message": "Undelete operation not supported for organization type",
  "severity": "VIOLATION"
}

LocationMustBePublished

Preconditions
orgId resolves to organization that is location owner

Definition	Severity	API	Sample	Mode
Validate that the location is PUBLISHED

Example Validation Report

{
  "code": "VALIDATION__LocationMustBePublished",
  "message": "Location '{{id}}' must be published before it may be updated",
  "severity": "VIOLATION",
  "context": {
    "id": "9467895078742654451"
  }
}

Partners Location Version

PartnersLocationVersionMustNotBeEmpty

Definition	Severity	API	Sample	Mode
Validate that partnersLocationVersion is not an empty string

PartnersLocationVersionIsMatched

Definition	Severity	API	Sample	Mode
Validate that partnersLocationVersion is not matched

PartnersLocationVersionHasUnsupportedCharacter

Definition	Severity	API	Sample	Mode
Validate that partnersLocationVersion does not include an unsupported character			Link

Resource State

LocationStateDoesNotAllowUndelete

Definition	Severity	API	Sample	Mode
Validate that resource state is not FAILED or REJECTED

Store Code

StoreCodeMustNotBeEmpty

Definition	Severity	API	Sample	Mode
Validate that storeCode is not an empty string

StoreCodeMustNotExceedMaximum

Definition	Severity	API	Sample	Mode
Validate that storeCode length does not exceed a maximum value (255)

StoreCodeMustNotIncludeURL

Definition	Severity	API	Sample	Mode
Validate that storeCode does not include a URL			Link

StoreCodeHasUnsupportedCharacter

Definition	Severity	API	Sample	Mode
Validate that storeCode does not include an unsupported character			Link