Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

StructuredValue description is confusing #109

danbri opened this issue Aug 28, 2014 · 6 comments

StructuredValue description is confusing #109

danbri opened this issue Aug 28, 2014 · 6 comments
Labels vocab General top level tag for issues on the vocabulary


Copy link

danbri commented Aug 28, 2014

"If you are messing around near StructuredValue, it would probably be worthwhile to fix up the comment on StructuredValue, which says that structured values are strings, but all the subclasses of StructuredValue are not strings." -- "Structured values are strings—for example, addresses—that have certain constraints on their structure."


More specific Types

@danbri danbri added this to the v2.0 milestone Sep 12, 2014
@danbri danbri added vocab General top level tag for issues on the vocabulary enhancement labels Sep 12, 2014
Copy link
Contributor Author

danbri commented Apr 17, 2015

See also #394

Copy link

mfhepp commented Apr 18, 2015

There is a pull request for this at #395

Copy link
Contributor Author

danbri commented Apr 24, 2015

Moving my comment in here from #395 pull request. It was:

""""Structured values are values that consist of sub-elements and thus have some kind of internal structure."

Thanks for making an exact suggestion. We haven't so far used the term "element" heavily; it sounds rather XML-oriented.

Maybe something like "Structured values are used when the value of a property has more complex structure than simply being a textual value or a reference to another thing."?"""

/cc @vholland @rvguha

Copy link

chaals commented Apr 30, 2015


Copy link

reavels commented Oct 3, 2016

I'm still confused by this to be honest.
I can understand the difference between simple and complex (structured) types, such that a simple type is string, datetime, number, etc which don't have properties and a structured type has properties.
Obviously, this definition doesn't work in because everything is inherited from Thing which has properties...but then how is a StructuredValue different to say Person as the value type of the owner property, or Event as the value type of the event property?
...hopefully someone can clear up my cloudy view here...

Copy link

thadguidry commented Oct 3, 2016

Its a Parent Type for holding ANY structured value.


Like my old high school locker combination.
Instead of simply saying its a Text value.
I could instead say its a StructuredValue

Then proceed to describe the structure.

Type = StructuredValue

This is a quick hack and not very applicable, but should help you
understand that StructuredValue lets you build structure for values...where might not have a Type for your Structure yet... Like my
LockCombination subtype above.

In we use StructuredValue as a parent Type for all those
subtypes that you see on the page, like OpeningHoursSpecification,
GeoShape, etc.

Just don't expect the Search Enginges to fully understand your
StructuredValue, but they will understand that IT IS A StructuredValue that
your describing and not some arbitrary text like 16R22L12R.

Use it when you can breakdown a value itself into ...into parts, etc. like
my high school locker combination... or even an automobile's VIN
number...if you wanted to...or an ISO Code... any value that consists of
parts and you want to describe further those parts so that others might
understand more about it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels vocab General top level tag for issues on the vocabulary
None yet

No branches or pull requests

5 participants