Skip to content

Instantly share code, notes, and snippets.

@Daseean
Last active July 12, 2025 05:29
Show Gist options
  • Select an option

  • Save Daseean/f484b58597ebeee7279a945e3874f389 to your computer and use it in GitHub Desktop.

Select an option

Save Daseean/f484b58597ebeee7279a945e3874f389 to your computer and use it in GitHub Desktop.

1. The "Secret Sauce": Explicit Entity Linking

This is the most powerful technique used here and the primary reason for its success in Maps rankings. The schema doesn't just hope Google connects the dots; it provides a direct, unambiguous road map.

mainEntityOfPage: Look at this property in the WebPage and HVACBusiness schemas:

"mainEntityOfPage" : [
  "https://anytownhvacpros.com/hvac-services-anytown/",
  "https://www.google.com/maps?cid=12345678901234567890",
  "https://www.google.com/search?kgmid=/g/12345abcde"
],

This is the jackpot. It's telling Google:

  • The primary entity of this page is the business itself.
  • This business is the exact same entity as the Google Maps listing with the CID (Customer ID) 12345678901234567890. This is a direct link to their Google Business Profile.
  • This business is also the exact same entity as the Google Knowledge Graph item with the machine-readable ID /g/12345abcde.

By doing this, it removes all ambiguity. It's the digital equivalent of pointing directly at your listing on a map and saying "That's me!"

sameAs and knowsAbout: Throughout the schema, concepts are linked to authoritative sources.

{
  "@type": "Thing",
  "name": "Anytown",
  "sameAs": [
    "https://en.wikipedia.org/wiki/Anytown,_USA",
    "https://www.google.com/search?q=anytown&kgmid=/m/0abcde"
  ]
}

This tells Google, "When I say 'Anytown', I'm referring to the specific place defined by this Wikipedia article and this Google Knowledge Graph entry." This builds immense semantic relevance and topical authority for both the services and the location.

2. Hyper-Specific and Detailed Business & Service Information

The schema uses the most specific types available and fills them out completely.

  • HVACBusiness: Instead of the generic LocalBusiness, it uses HVACBusiness. This immediately categorizes the company correctly.
  • Comprehensive areaServed: This is crucial for a service-area business. It doesn't just list a city. It provides:
    • A list of postal codes.
    • A list of City names, each with a direct URL to its respective Google Maps page. This is a brilliant way to reinforce the service area.
  • Individual Service Schemas: They didn't just list "HVAC" as a service. They created separate, interconnected Service nodes for every single offering (air duct cleaning, AC repair, furnace install, etc.).
    • Each service has its own @id, name, description, url (linking to the relevant service page), and provider (linking back to the main business entity).
    • The HVACBusiness schema then uses the makesOffer property to link to the @id of each of these services. This creates a crystal-clear map of Business -> offers -> Service.

3. Deep Interlinking Using @graph and @id

The entire schema is wrapped in a @graph. This allows for multiple, distinct schema "nodes" (like WebPage, HVACBusiness, Person, etc.) to be defined in one block and then cross-referenced using the @id property.

Example: The HVACBusiness is given an @id of ...#Anytown. Later, the WebPage schema's creator property simply refers to that ID: "creator":{"@id": "...#Anytown"}.

This creates a clean, machine-readable web of relationships: This WebPage was created by this HVACBusiness, which offers these specific Services, is run by this Person, and is the same as this Google Maps Listing.

4. Demonstrating E-E-A-T (Expertise, Authoritativeness, Trustworthiness)

Google's ranking guidelines heavily emphasize E-E-A-T, and this schema builds it directly into the code.

  • Person Schema: It defines the owner, "John Doe," as a Person. It includes his jobTitle, description, awards, and even his hasOccupation with an industry-standard occupational code. This establishes him as a real, expert human behind the business.
  • aggregateRating and review: Including a 5-star rating from a significant number of reviews, and even a full sample review, provides direct social proof and trust signals.
  • citation: The WebPage schema cites other online profiles, suggesting the business creates content and has a presence on other platforms, which builds authority.
  • Event Schema: The inclusion of a "Free Estimate Sales Event" with dates, locations (both virtual and physical), and offers further establishes the business as active and legitimate.

Summary: Why it Works so Well

This schema is a masterclass in modern local SEO because it:

  • Speaks Google's Language: It uses specific schema types and links them directly to Google's own entities (Maps CID, Knowledge Graph ID), leaving no room for interpretation.
  • Is Incredibly Thorough: It provides exhaustive detail about every aspect of the business: what it is, what it does, where it operates, who runs it, and what customers think of it.
  • Is Perfectly Structured: It uses the @graph and @id system to create a tightly-woven, logical network of information that is easy for a machine to parse and understand.
  • Proactively Builds Trust: It incorporates E-E-A-T signals like author information, reviews, and external links directly into the structured data.

In short, it's not just "adding schema." It's a strategic effort to provide Google with a perfect, pre-digested summary of the business entity, which directly fuels its ability to rank that business confidently and accurately in local and Maps search results.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment