GeoCircle

GeoCircle is a GeoShape subtype describing a circular geographic region. Properties: geoMidpoint (GeoCoordinates) and geoRadius (Distance — typically a number-in-metres string like "5000"). Used on LocalBusiness.areaServed and Service.areaServed for "within X of a point" coverage.

Full example of schema.org/GeoCircle json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/GeoCircle

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Xoo Code same-day delivery (Copenhagen)",
  "areaServed": {
    "@type": "GeoCircle",
    "geoMidpoint": { "@type": "GeoCoordinates", "latitude": 55.6761, "longitude": 12.5683 },
    "geoRadius": "10000"
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid GeoCircle entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/GeoCircle (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "GeoCircle",
  "geoMidpoint": { "@type": "GeoCoordinates", "latitude": 55.6761, "longitude": 12.5683 },
  "geoRadius": "5000"
}
</script>

Google rich results this unlocks

GeoCircle is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). GeoCircle becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common GeoCircle mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
geoRadius with unit
Wrong
```
"geoRadius": "5km"
```
Right
```
"geoRadius": "5000" (metres)
```
geoRadius is a number string in metres by convention; units inline confuse parsers.

Schema properties in this example

GeoCircle GeoShape StructuredValue geoMidpoint GeoCoordinates latitude longitude geoRadius areaServed

About the example data

Xoo Code's Copenhagen same-day-delivery zone — 10 km from Rådhuspladsen.

Comments

Loading comments...