GeoCircle

Тип schema.org ^?

Thing > Intangible > StructuredValue > GeoShape > GeoCircle

Канонический URL: https://schema.org/GeoCircle
👉 Проверить на наличие открытых проблем.

Содержание: Описание, Свойства которые можно использовать, Примеры использования.

Описание:

GeoCircle — это GeoShape, представляющий собой круговую географическую область. Поскольку это GeoShape, он предоставляет простое текстовое свойство 'circle', но также позволяет комбинировать почтовый индекс с geoRadius. Центр круга может быть указан с помощью свойства 'geoMidpoint' или более приблизительно с использованием 'address', 'postalCode'.

GeoCircle — это тип данных в Schema.org, который используется для описания круглой географической области. Он представляет собой геометрическую фигуру, которая может быть полезна в различных контекстах, связанных с геолокацией и картографией.

Основное назначение GeoCircle заключается в том, чтобы обозначить определенный радиус вокруг заданной точки на карте. Эта точка определяется с помощью свойства 'geoMidpoint', которое указывает на центр круга. Кроме того, можно использовать более общие данные, такие как адрес или почтовый индекс, чтобы указать местоположение центра круга.

GeoCircle также включает в себя свойства, которые позволяют указать радиус действия, то есть расстояние от центра до границы круга. Это может быть полезно, например, для определения зоны обслуживания, области поиска или географических ограничений.

Использование GeoCircle может быть актуально для различных приложений, таких как карты, сервисы доставки, системы геомаркетинга и многие другие, где важно точно определить географическую область. В целом, GeoCircle помогает упростить и стандартизировать способ представления информации о географических областях в интернете, что способствует лучшему пониманию и обработке данных о местоположении.

Свойство	Ожидаемый тип	Описание
Свойство из GeoCircle
geoMidpoint	GeoCoordinates	Указывает на географические координаты в центре геофигуры, например, геокруга.
geoRadius	Distance, Number, Text	Указывает приблизительный радиус геокруга (метры, если не указано иное с помощью обозначения расстояния).
Свойство из GeoShape
address	PostalAddress, Text	Физический адрес объекта.
addressCountry	Country, Text	Страна. Например, США. Вы также можете предоставить двухбуквенный ISO 3166-1 alpha-2 код страны.
box	Text	Коробка — это область, ограниченная прямоугольником, образованным двумя точками. Первая точка — это нижний угол, вторая точка — верхний угол. Коробка выражается как две точки, разделенные пробелом.
circle	Text	Круг — это круговая область заданного радиуса, центрированная на заданной широте и долготе. Круг выражается как пара, за которой следует радиус в метрах.
elevation	Number, Text	Высота местоположения (WGS 84). Значения могут быть в форме 'ЧИСЛО ЕДИНИЦА_ИЗМЕРЕНИЯ' (например, '1,000 м', '3,200 футов'), в то время как числа без единиц измерения следует считать значением в метрах.
line	Text	Линия — это путь от точки до точки, состоящий из двух или более точек. Линия выражается как серия из двух или более объектов точек, разделенных пробелом.
polygon	Text	Многоугольник — это область, ограниченная путем от точки к точке, для которого начальная и конечная точки совпадают. Многоугольник выражается как серия из четырех и более разделенных пробелами точек, где первая и последняя точки идентичны.
postalCode	Text	Почтовый индекс. Например, 94043.
Свойство из Thing
additionalType	URL, Text	Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org.
alternateName	Text	Псевдоним для элемента.
description	Text, TextObject	Описание предмета.
disambiguatingDescription	Text	Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения.
identifier	PropertyValue, Text, URL	Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей.
image	ImageObject, URL	Изображение предмета. Это может быть URL или полностью описанный ImageObject.
mainEntityOfPage	CreativeWork, URL	Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей.
name	Text	Название элемента.
potentialAction	Action	Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'.
sameAs	URL	URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт.
subjectOf	CreativeWork, Event	Творческое произведение или событие, связанное с этой вещью.
url	URL	URL предмета.

Примеры

Пример 1

Пример заметки или HTML разметки.


Joes' Pizza
123 Main Street
Cambridge, MA 02142
delivers within 5 km of its store with a minimum order of $20.

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/FoodEstablishment">
  <span itemprop="name">Joe's Pizza</span>
  <div itemprop="location" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">123 Main Street</span>
    <span itemprop="addressLocality">Cambridge</span>
    <span itemprop="addressRegion">MA</span>
    <span itemprop="postalCode">02142</span>
  </div>
  delivers within 5 km of its store
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer">
    <div itemprop="eligibleRegion" itemscope itemtype="https://schema.org/GeoCircle">
      <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
        <meta itemprop="streetAddress" content="123 Main Street" />
        <meta itemprop="addressLocality" content="Cambridge" />
        <meta itemprop="addressRegion" content="MA" />
        <meta itemprop="postalCode" content="02142" />
      </div>
      <meta itemprop="geoRadius" content="5000" />
    </div>

    with a minimum order of $20.
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/DeliveryChargeSpecification">
      <meta itemprop="appliesToDeliveryMethod" link="http://purl.org/goodrelations/v1#DeliveryModeOwnFleet">
      <div itemprop="eligibleTransactionVolume" itemscope itemtype="https://schema.org/PriceSpecification">
        <meta itemprop="price" content="20.00" />
        <meta itemprop="priceCurrency" content="USD" />
      </div>
    </div>
  </div>
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="FoodEstablishment">
  <span property="name">Joe's Pizza</span>
  <div property="location" typeof="PostalAddress">
    <span property="streetAddress">123 Main Street</span>
    <span property="addressLocality">Cambridge</span>
    <span property="addressRegion">MA</span>
    <span property="postalCode">02142</span>
  </div>
  delivers within 5 km of its store with a minimum order of $20.
  <div property="makesOffer" typeof="Offer">
    <div property="priceSpecification" typeof="DeliveryChargeSpecification">
      <meta property="appliesToDeliveryMethod" link="http://purl.org/goodrelations/v1#DeliveryModeOwnFleet">
      <div property="eligibleTransactionVolume" typeof="PriceSpecification">
        <meta property="price" content="20.00" />
        <meta property="priceCurrency" content="USD" />
      </div>
      <div property="eligibleRegion" typeof="GeoCircle">
        <div property="address" typeof="PostalAddress">
          <meta property="streetAddress" content="123 Main Street" />
          <meta property="addressLocality" content="Cambridge" />
          <meta property="addressRegion" content="MA" />
          <meta property="postalCode" content="02142" />
        </div>
        <meta property="geoRadius" content="5000" />
      </div>
    </div>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "FoodEstablishment",
    "name": "Joe's Pizza",
    "location": {
      "@type": "PostalAddress",
      "@id": "http://example.com/address",
      "streetAddress": "123 Main Street",
      "addressLocality": "Cambridge",
      "addressRegion": "MA",
      "postalCode": "02142"
    },
    "makesOffer": {
      "@type": "Offer",
      "priceSpecification": {
        "@type": "DeliveryChargeSpecification",
        "appliesToDeliveryMethod": "http://purl.org/goodrelations/v1#DeliveryModeOwnFleet",
        "eligibleTransactionVolume": {
          "@type": "PriceSpecification",
          "price": "20.00",
          "priceCurrency": "USD"
        },
        "eligibleRegion": {
          "@type": "GeoCircle",
          "address": {
            "@id": "http://www.example.com/address"
          },
          "geoRadius": "5000"
        }
      }
    }
  }
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org/

@type

FoodEstablishment

name

Joe's Pizza

location

@type: PostalAddress
@id: http://example.com/address
streetAddress: 123 Main Street
addressLocality: Cambridge
addressRegion: MA
postalCode: 02142

makesOffer

@type

Offer

priceSpecification

@type

DeliveryChargeSpecification

appliesToDeliveryMethod

http://purl.org/goodrelations/v1#DeliveryModeOwnFleet

eligibleTransactionVolume

@type: PriceSpecification
price: 20.00
priceCurrency: USD

eligibleRegion

@type

GeoCircle

address

@id: http://www.example.com/address

geoRadius

5000

Пример 2

Пример заметки или HTML разметки.


Car for hire driver #123 is within 50 meters of a given location, but is moving.

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/TaxiService">
  <div itemprop="provider" itemscope itemtype="https://schema.org/LocalBusiness">
    <span itemprop="name">driver #123</span>
    <div itemprop="location" itemscope itemtype="https://schema.org/Place">
      <div itemprop="geo" itemscope itemtype="https://schema.org/GeoCircle">
        <div itemprop="geoMidpoint" itemscope itemtype="https://schema.org/GeoCoordinates">
          <meta itemprop="latitude" content="42.362757" />
          <meta itemprop="longitude" content="-71.087109" />
        </div>
        <meta itemprop="geoRadius" content="50" />
      </div>
    </div>
  </div>
  <meta itemprop="providerMobility" content="dynamic" />
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="TaxiService">
  <div property="provider" typeof="LocalBusiness">
    <span property="name">driver #123</span>
    <div property="location" typeof="Place">
      <div property="geo" typeof="GeoCircle">
        <div property="geoMidpoint" typeof="GeoCoordinates">
          <meta property="latitude" content="42.362757" />
          <meta property="longitude" content="-71.087109" />
        </div>
        <meta property="geoRadius" content="50" />
      </div>
    </div>
  </div>
  <meta property="providerMobility" content="dynamic" />
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "TaxiService",
    "provider": {
      "@type": "LocalBusiness",
      "name": "driver #123",
      "location": {
        "@type": "Place",
        "geo": {
          "@type": "GeoCircle",
          "geoMidpoint": {
            "@type": "GeoCoordinates",
            "latitude": "42.362757",
            "longitude": "-71.087109"
          },
          "geoRadius": "50"
        }
      }
    },
    "providerMobility": "dynamic"
  }
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org/

@type

TaxiService

provider

@type

LocalBusiness

name

driver #123

location

@type