About
Entities Become More Useful When Connected.
The USA Graph is the entity, relationship, context and knowledge-connection layer of The USA Stack. It answers one question: how is everything connected?
ARCHITECTURE
Entity Resolution
Is This the Same Entity?
Different sources describe the same business in different ways. Resolution prevents duplicate nodes and fragmented identities. Production matching does not exist yet.
“Grandma's Saloon”
“Grandmas Saloon & Grill”
“Grandma's Restaurant Duluth”
- SOURCE A · SOURCE B · SOURCE C
- ENTITY RESOLUTION
- CANONICAL ENTITY
Potential Signals
NameAddressPhoneWebsiteBusiness Record IDGeographyCategorySource authorityConfidence
Canonical Entity
Many References. One Entity.
Website listingMarketplace listingPublisher mentionBusiness RecordSocial profileEvent listingDirectory listing
- CANONICAL ENTITY
- ENTITY ID
Provenance · Claims
Don't Just Store Relationships. Know Where They Came From.
- SOURCE
- CLAIM
- EVIDENCE
- VERIFICATION
- ENTITY / RELATIONSHIP
- A source provides information.
- That information creates a claim.
- Evidence supports or contradicts the claim.
- Verification determines the claim's status.
- Verified claims can support canonical entity attributes or graph relationships.
This distinction matters for human-submitted, publisher-derived, API-derived, crawled and AI-derived information. INFERRED is never equivalent to VERIFIED.
- Source URL / Record
- Source Type
- Claim
- Observed Value
- Confidence
- Verification
- Timestamp
- Evidence
Grid + Graph
Grid = Where. Graph = How It Relates.
The USA Grid · WHERE
- Nodes
- Geography
- Network
- Deployment
- Location
The USA Graph · HOW
- Entities
- Relationships
- Context
- Meaning
- Connections
- GRID + GRAPH
- A machine-readable model of local America.
Entity→Relationship
Relationship→Context
Context→Knowledge