Location descriptions validation rules for text content, locales, length limits, and content restrictions

Change Detection

SuspiciousRemovalOfLocationDescriptions

Definition	Severity	API	Sample	Mode
Validate that locationDescriptions is present when previously submitted

Location Descriptions

CountOfValuesInDescriptionsListExceedsThreshold

Definition	Severity	API	Sample	Mode
Validate that the count of descriptions values in a list does not exceed one hundred seventy-eight (178)

LocationDescriptionsListMustNotIncludeNulls

Definition	Severity	API	Sample	Mode
Validate that a list does not include null

LocationDescriptionsMustNotBeEmptyArray

Definition	Severity	API	Sample	Mode
Validate that locationDescriptions is not an empty array

Example Validation Report

{
  "code": "VALIDATION__LocationDescriptionsMustNotBeEmptyArray",
  "message": "'{{field}}' must be omitted or contain at least one element; empty arrays are not allowed.",
  "severity": "VIOLATION",
  "context": {
    "field": "locationDescriptions"
  },
  "details": {
    "compared": [],
    "expected": [],
    "submitted": [
      {
        "field": "$.locationDetails.locationDescriptions",
        "value": "[]"
      }
    ],
    "createdDate": "2026-03-03T13:58:43.946Z"
  }
}

Descriptions

LocationDescriptionsDescriptionsListMustNotIncludeNulls

Definition	Severity	API	Sample	Mode
Validate that a list does not include null

LocationDescriptionsNestedDescriptionsMustNotBeEmptyArray

Definition	Severity	API	Sample	Mode
Validate that locationDescriptions[].descriptions is not an empty array

Example Validation Report

{
  "code": "VALIDATION__LocationDescriptionsNestedDescriptionsMustNotBeEmptyArray",
  "message": "'{{field}}' must be omitted or contain at least one element; empty arrays are not allowed.",
  "severity": "VIOLATION",
  "context": {
    "field": "descriptions"
  },
  "details": {
    "compared": [],
    "expected": [],
    "submitted": [
      {
        "field": "$.locationDetails.locationDescriptions[0].descriptions",
        "value": "[]"
      }
    ],
    "createdDate": "2026-03-03T13:58:43.946Z"
  }
}

Locale

DescriptionsLocaleMustBeDistinct

Definition	Severity	API	Sample	Mode
Validate that each locale is distinct

DescriptionsLocaleMustBePresent

Preconditions
locationDescriptions is present

Definition	Severity	API	Sample	Mode
Validate that locale is present			Link

DescriptionsLocaleMustBeValid

Definition	Severity	API	Sample	Mode
Validate that locale is valid			Link

DescriptionsLocaleMustNotBeEmpty

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

DescriptionsRequiresAtLeastOneSupportedLocale

Definition	Severity	API	Sample	Mode
Validate that at least one (1) supported locale is present

Text

DescriptionsTextHasSuspectedTemplatePlaceholder

Definition	Severity	API	Sample	Mode
Validate that text does not include a suspected unfilled template placeholder. For example, [city], {city}, and so on.

Example Validation Report

{
  "code": "VALIDATION__DescriptionsTextHasSuspectedTemplatePlaceholder",
  "message": "'{{field}}' includes a suspected unfilled template placeholder",
  "severity": "VIOLATION",
  "context": {
    "field": "text"
  },
  "details": {
    "compared": [],
    "expected": [],
    "submitted": [
      {
        "field": "$.locationDetails.locationDescriptions[0].descriptions[0].locale",
        "value": "en-US"
      },
      {
        "field": "$.locationDetails.locationDescriptions[0].descriptions[0].text",
        "value": "Visit our flower shop in [city] for fresh bouquets, seasonal arrangements, and same-day delivery."
      }
    ],
    "createdDate": "2026-09-01T21:00:59.865Z"
  }
}

DescriptionsTextHasSuspectedUnintentionalSequentialWordRepetition

Definition	Severity	API	Sample	Mode
Validate that text does not include an unintentional repetitive sequence of words

DescriptionsTextMustBePresent

Preconditions
locationDescriptions is present

Definition	Severity	API	Sample	Mode
Validate that text is present			Link

DescriptionsTextMustNotBeDummyCharacters

Definition	Severity	API	Sample	Mode
Validate that text is not exclusively dummy characters			Link

DescriptionsTextMustNotBeEmpty

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

DescriptionsTextNotBeEntirelyNumeric

Definition	Severity	API	Sample	Mode
Validate that the text value is not entirely numeric

DescriptionsTextMustNotExceedMaximum

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

DescriptionsTextMustNotIncludeURL

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

DescriptionsTextShouldNotMatch

Definition	Severity	API	Sample	Mode
Validate that text does not match among different locale values

DescriptionsText_ExpectedLangTagForCountryNotPresent

Preconditions
structuredAddress is present

Definition	Severity	API	Sample	Mode
Validate that at least one (1) primary language tag is present corresponding to a language expected to be spoken in the Country identified by countryCode in structuredAddress

DescriptionsText_ExpectedLangTagForDerivedCountryNotPresent

Preconditions
displayPoint is present
structuredAddress is not present

Definition	Severity	API	Sample	Mode
Validate that at least one (1) primary language tag is present corresponding to a language expected to be spoken in the Country derived from reverse geocoding Display Point coordinates

DescriptionsText_ExpectedRegionSubtagForDerivedCountryNotPresent

Preconditions
fullAddress is present

Definition	Severity	API	Sample	Mode
Validate that at least one (1) region subtag is present that corresponds with the country derived from fullAddress

DescriptionsText_ExpectedRegionSubtagForCountryNotPresent

Preconditions
structuredAddress is present

Definition	Severity	API	Sample	Mode
Validate that at least one (1) region subtag is present that corresponds with the Country identified by countryCode in structuredAddress

LocationDescriptionsTextHasUnsupportedCharacter

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

LocationDescriptionsTextMustNotIncludeVulgarWord

Definition	Severity	API	Sample	Mode
Validate that text does not include a vulgar word

Type

LocationDescriptionsTypeMustBePresent

Preconditions
locationDescriptions is present

Definition	Severity	API	Sample	Mode
Validate that type is present			Link

LocationDescriptionsTypeMustBeValid

Definition	Severity	API	Sample	Mode
Validate that type value is valid			Link

LocationDescriptionsTypeMustNotBeEmpty

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