Dati strutturati per attività locali (LocalBusiness)

Quando gli utenti cercano attività commerciali sulla Ricerca Google o su Maps, i risultati della Ricerca potrebbero mostrare una scheda informativa di Google in evidenza con i dettagli relativi a un'attività che soddisfa la query. Quando gli utenti ricercano un tipo di attività, ad esempio, "i migliori ristoranti di New York", possono vedere un carosello di attività commerciali correlate alla query. Con i dati strutturati delle attività locali, puoi comunicare a Google l'orario di apertura, i diversi reparti all'interno di un'attività, le recensioni (se il tuo sito raccoglie recensioni su altre attività) e altro ancora. Se vuoi aiutare gli utenti a effettuare una prenotazione o un ordine direttamente dai risultati della Ricerca, puoi utilizzare l'API Maps Booking per abilitare prenotazioni, pagamenti e altre azioni.

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据，可以详细了解结构化数据的运作方式。

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南，请查看结构化数据 Codelab。

  1. 添加必要属性。根据您使用的格式，了解在网页上的什么位置插入结构化数据。
  2. 遵循指南。
  3. 使用富媒体搜索结果测试验证您的代码，并修复所有严重错误。此外，您还可以考虑修正该工具中可能会标记的任何非严重问题，因为这些这样有助于提升结构化数据的质量（不过，要使内容能够显示为富媒体搜索结果，并非必须这么做）。
  4. 部署一些包含您的结构化数据的网页，然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问，不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题，您可以请求 Google 重新抓取您的网址。
  5. 为了让 Google 随时了解日后发生的更改，我们建议您提交站点地图。Search Console Sitemap API 可以帮助您自动执行此操作。

Esempi

Scheda di attività locale semplice

Ecco un esempio di una scheda di attività locale semplice che utilizza JSON-LD.

Scheda di attività locale sulla Ricerca Google


<html>
  <head>
    <title>Dave's Steak House</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Restaurant",
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "name": "Dave's Steak House",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "148 W 51st St",
        "addressLocality": "New York",
        "addressRegion": "NY",
        "postalCode": "10019",
        "addressCountry": "US"
      },
      "review": {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": 4,
          "bestRating": 5
        },
        "author": {
          "@type": "Person",
          "name": "Lillian Ruiz"
        }
      },
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": 40.761293,
        "longitude": -73.982294
      },
      "url": "https://www.example.com/restaurant-locations/manhattan",
      "telephone": "+12122459600",
      "servesCuisine": "American",
      "priceRange": "$$$",
      "openingHoursSpecification": [
        {
          "@type": "OpeningHoursSpecification",
          "dayOfWeek": [
            "Monday",
            "Tuesday"
          ],
          "opens": "11:30",
          "closes": "22:00"
        },
        {
          "@type": "OpeningHoursSpecification",
          "dayOfWeek": [
            "Wednesday",
            "Thursday",
            "Friday"
          ],
          "opens": "11:30",
          "closes": "23:00"
        },
        {
          "@type": "OpeningHoursSpecification",
          "dayOfWeek": "Saturday",
          "opens": "16:00",
          "closes": "23:00"
        },
        {
          "@type": "OpeningHoursSpecification",
          "dayOfWeek": "Sunday",
          "opens": "16:00",
          "closes": "22:00"
        }
      ],
      "menu": "https://www.example.com/menu"
    }
    </script>
  </head>
  <body>
  </body>
</html>

Ecco un esempio di un ristorante che soddisfa i requisiti di una pagina dei dettagli (supponendo che sia presente anche una pagina di riepilogo con il markup Carosello). Attualmente il carosello dei ristoranti è limitato a un piccolo gruppo di ristoratori. Se vuoi partecipare, comunicaci il tuo interesse tramite il nostro modulo. 

<html>
  <head>
    <title>Trattoria Luigi</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Restaurant",
      "name": "Trattoria Luigi",
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
       "priceRange": "$$$",
       "servesCuisine": "Italian",
       "telephone": "+12125557234",
       "address": {
         "@type": "PostalAddress",
         "streetAddress": "148 W 51st St",
         "addressLocality": "New York",
         "addressRegion": "NY",
         "postalCode": "10019",
         "addressCountry": "US"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Orario di apertura

I seguenti esempi mostrano come eseguire il markup per i diversi tipi di orari di apertura.

Orari standard

Se si escludono le proprietà validFrom e validThrough, gli orari sono validi tutto l'anno. Questo esempio definisce un'attività aperta dalle 09:00 alle 21:00 nei giorni feriali e dalle 10:00 alle 23:00 durante il fine settimana.

"openingHoursSpecification": [
  {
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": [
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday"
    ],
    "opens": "09:00",
    "closes": "21:00"
  },
  {
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": [
      "Saturday",
      "Sunday"
    ],
    "opens": "10:00",
    "closes": "23:00"
  }
]
Orari notturni

Per gli orari dopo la mezzanotte, definisci l'orario di apertura e di chiusura utilizzando una singola proprietà OpeningHoursSpecification. Questo esempio definisce gli orari dalle 18:00 di sabato fino alle 03:00 di domenica.

"openingHoursSpecification": {
  "@type": "OpeningHoursSpecification",
  "dayOfWeek": "Saturday",
  "opens": "18:00",
  "closes": "03:00"
}
Attività aperte tutto il giorno

Per mostrare che un'attività è aperta 24 ore al giorno, imposta la proprietà open su "00:00" e la proprietà closes su "23:59". Per mostrare che un'attività è chiusa tutto il giorno, imposta entrambe le proprietà opens e closes su "00:00". Questo esempio mostra un'attività aperta sabato per tutto il giorno e chiusa domenica per tutto il giorno.

"openingHoursSpecification": [
  {
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": "Saturday",
    "opens": "00:00",
    "closes": "23:59"
  },
  {
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": "Sunday",
    "opens": "00:00",
    "closes": "00:00"
  }
]
Orari stagionali

Utilizza le proprietà validFrom e validThrough per definire gli orari stagionali. Questo esempio mostra un'attività chiusa per le festività invernali.

"openingHoursSpecification": {
  "@type": "OpeningHoursSpecification",
  "opens": "00:00",
  "closes": "00:00",
  "validFrom": "2015-12-23",
  "validThrough": "2016-01-05"
}

Più reparti

Nel caso di un'attività divisa in reparti, ciascuno con proprietà distinte, come orari di apertura o numeri di telefono, puoi eseguire il markup della proprietà department con un elemento per ciascun reparto. Definisci singolarmente le proprietà che differiscono dall'attività principale in ciascun elemento del rispettivo reparto.

<html>
  <head>
    <title>Dave's Department Store</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Store",
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "name": "Dave's Department Store",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "1600 Saratoga Ave",
        "addressLocality": "San Jose",
        "addressRegion": "CA",
        "postalCode": "95129",
        "addressCountry": "US"
      },
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": 37.293058,
        "longitude": -121.988331
      },
      "url": "https://www.example.com/store-locator/sl/San-Jose-Westgate-Store/1427",
      "priceRange": "$$$",
      "telephone": "+14088717984",
      "openingHoursSpecification": [
        {
          "@type": "OpeningHoursSpecification",
          "dayOfWeek": [
            "Monday",
            "Tuesday",
            "Wednesday",
            "Thursday",
            "Friday",
            "Saturday"
          ],
          "opens": "08:00",
          "closes": "23:59"
        },
        {
          "@type": "OpeningHoursSpecification",
          "dayOfWeek": "Sunday",
          "opens": "08:00",
          "closes": "23:00"
        }
      ],
      "department": [
        {
          "@type": "Pharmacy",
          "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
          "name": "Dave's Pharmacy",
          "address": {
            "@type": "PostalAddress",
            "streetAddress": "1600 Saratoga Ave",
            "addressLocality": "San Jose",
            "addressRegion": "CA",
            "postalCode": "95129",
            "addressCountry": "US"
          },
          "priceRange": "$",
          "telephone": "+14088719385",
          "openingHoursSpecification": [
            {
              "@type": "OpeningHoursSpecification",
              "dayOfWeek": [
                "Monday",
                "Tuesday",
                "Wednesday",
                "Thursday",
                "Friday"
              ],
              "opens": "09:00",
              "closes": "19:00"
            },
            {
              "@type": "OpeningHoursSpecification",
              "dayOfWeek": "Saturday",
              "opens": "09:00",
              "closes": "17:00"
            },
            {
              "@type": "OpeningHoursSpecification",
              "dayOfWeek": "Sunday",
              "opens": "11:00",
              "closes": "17:00"
            }
          ]
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Linee guida

Segui queste linee guida per l'idoneità all'inclusione in un risultato avanzato di tipo attività locale.

Definizioni dei tipi di dati strutturati

Le seguenti tabelle elencano le proprietà e l'utilizzo per i tipi di azioni relativi ad attività commerciali e attività commerciali locali, in base alle definizioni complete disponibili all'indirizzo schema.org/LocalBusiness.

Affinché i tuoi contenuti siano idonei per la visualizzazione come risultato avanzato, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni sui contenuti e offrire così un'esperienza utente migliore.

Puoi aggiungere dati strutturati LocalBusiness a qualsiasi pagina del tuo sito, anche se potrebbe essere più utile inserirli in una pagina contenente informazioni sulla tua attività.

LocalBusiness

La definizione completa di LocalBusiness è disponibile all'indirizzo schema.org/LocalBusiness. Definisci ogni sede dell'attività locale come tipo LocalBusiness. Utilizza il sottotipo di LocalBusiness più specifico possibile, ad esempio Restaurant, DaySpa, HealthClub e così via.

Se sono presenti più tipi, specificali in un array (additionalType non è supportato). Ad esempio, se la tua attività offre più servizi:

{
  "@context": "https://schema.org",
  "@type": ["Electrician", "Plumber", "Locksmith"],
  ....
}

Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie
address

PostalAddress

La sede fisica dell'attività. Includi quante più proprietà possibile: maggiore il numero di proprietà, maggiore sarà la qualità del risultato per gli utenti. Ad esempio:

"address": {
  "@type": "PostalAddress",
  "streetAddress": "148 W 51st St Suit 42 Unit 7",
  "addressLocality": "New York",
  "addressRegion": "NY",
  "postalCode": "10019",
  "addressCountry": "US"
}
name

Text

Il nome dell'attività commerciale.
Proprietà consigliate
aggregateRating

AggregateRating

Questa proprietà è consigliata solo per i siti che acquisiscono recensioni su altre attività locali: la valutazione media dell'attività locale in base a più valutazioni o recensioni. Segui le linee guida sugli snippet recensione e l'elenco di proprietà relative alla valutazione complessiva del datore di lavoro obbligatorie e consigliate.
department

LocalBusiness

Un elemento nidificato per un singolo reparto. Puoi definire qualsiasi proprietà in questa tabella per un reparto.

Linee guida aggiuntive:

  • Includi il nome del negozio con il nome del reparto nel seguente formato: {store name} {department name}. Ad esempio, gMart e gMart Pharmacy.
  • Se il nome del reparto include un brand specifico, specifica un nome di reparto da solo. Ad esempio, Best Buy e Geek Squad.
geo

GeoCoordinates

Le coordinate geografiche dell'attività.
geo.latitude

Number

La latitudine della sede dell'attività commerciale. La precisione deve essere di almeno 5 cifre decimali.
geo.longitude

Number

La longitudine della sede dell'attività commerciale. La precisione deve essere di almeno 5 cifre decimali.
menu

URL

Per le attività alimentari, l'URL completo del menu.
openingHoursSpecification

Array o singolo oggetto (entrambi supportati) di OpeningHoursSpecification

Orari durante i quali la sede dell'attività è aperta.
openingHoursSpecification.closes

Time

L'orario in cui la sede dell'attività chiude, in formato hh:mm:ss.
openingHoursSpecification.dayOfWeek

DayOfWeek

Uno o più dei seguenti valori:

  • https://schema.org/Monday: il giorno noto come lunedì.
  • https://schema.org/Tuesday: il giorno noto come martedì.
  • https://schema.org/Wednesday: il giorno noto come mercoledì.
  • https://schema.org/Thursday: il giorno noto come giovedì.
  • https://schema.org/Friday: il giorno noto come venerdì.
  • https://schema.org/Saturday: il giorno noto come sabato.
  • https://schema.org/Sunday: il giorno noto come domenica.
openingHoursSpecification.opens

Time

L'orario in cui la sede dell'attività apre, in formato hh:mm:ss.
openingHoursSpecification.validFrom

Date

La data di inizio della chiusura stagionale di un'attività, in formato AAAA-MM-GG.
openingHoursSpecification.validThrough

Date

La data di fine della chiusura stagionale di un'attività, in formato AAAA-MM-GG.
priceRange

Text

La fascia di prezzo relativa di un'attività commerciale, in genere specificata tramite un intervallo numerico (ad esempio, "10-15 $") o un numero normalizzato di segni di valuta (ad esempio, "$$$")

Questo campo deve contenere meno di 100 caratteri. Se è composto da almeno 100 caratteri, Google non mostrerà una fascia di prezzo per l'attività.
review

Review

Questa proprietà è consigliata solo per i siti che acquisiscono recensioni su altre attività locali: una recensione dell'attività locale. Segui le linee guida sugli snippet recensione e l'elenco di proprietà Recensione obbligatorie e consigliate.
servesCuisine

servesCuisine

Il tipo di cucina servita nel ristorante.
telephone

Text

Un numero di telefono dell'attività destinato a essere il metodo di contatto principale per i clienti. Assicurati di includere il codice paese e il prefisso.
url

URL

L'URL completo della sede specifica dell'attività. L'URL deve essere un link funzionante.

Se nel tuo sito sono presenti più ristoranti e vuoi che siano idonei per un carosello host, aggiungi l'oggetto Carousel. Oltre alle proprietà del carosello standard, definisci le seguenti proprietà nell'oggetto Carousel. Sebbene le proprietà del carosello non siano obbligatorie, devi aggiungere le proprietà seguenti se vuoi che il tuo elenco di ristoranti sia idoneo per un carosello host.

Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie
image

Proprietà ripetuta URL o ImageObject

Una o più immagini del ristorante.

Ulteriori linee guida per le immagini:

  • Gli URL delle immagini devono poter essere sottoposti a scansione e indicizzazione. Per verificare se Google può accedere agli URL, utilizza lo strumento Controllo URL.
  • Le immagini devono rappresentare i contenuti con markup.
  • Le immagini devono essere in un formato file supportato da Google Immagini.
  • Per ottenere risultati ottimali, ti consigliamo di fornire più immagini ad alta risoluzione (minimo 50.000 pixel moltiplicando larghezza e altezza) nei seguenti formati: 16x9, 4x3 e 1x1.

Ad esempio:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
name

Text

Il nome del ristorante.
Proprietà consigliate
address

PostalAddress

La sede fisica dell'attività. Includi quante più proprietà possibile: maggiore il numero di proprietà, maggiore sarà la qualità del risultato per gli utenti. Ad esempio:

"address": {
  "@type": "PostalAddress",
  "streetAddress": "148 W 51st St",
  "addressLocality": "New York",
  "addressRegion": "NY",
  "postalCode": "10019",
  "addressCountry": "US"
}
servesCuisine

servesCuisine

Il tipo di cucina servita nel ristorante.

Risoluzione dei problemi

Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.