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

The serviceArea property should have a range of Place not AdministrativeArea #411

Closed
vholland opened this issue Apr 6, 2015 · 20 comments
Closed
Assignees
Labels
schema.org vocab General top level tag for issues on the vocabulary

Comments

@vholland
Copy link
Contributor

vholland commented Apr 6, 2015

The serviceArea property can be used for Places that are not AdministrativeAreas.

@vholland vholland self-assigned this Apr 6, 2015
@vholland vholland added this to the 2015 Q2 milestone Apr 6, 2015
@mfhepp
Copy link
Contributor

mfhepp commented Apr 6, 2015

I am fine with this, but we should add a note that recommends the more granular offer -> eligibleRegion / availableAtOrFrom / delivery options patterns.

@jvandriel
Copy link

If I might ask, @mfhepp how about merging eligibleRegion and availableAtOrFrom to one property named serviceArea?

Personally I find it hard to tell when to use eligibleRegion or availableAtOrFrom, and every time I deploy either of them I always have this nagging voice in the back of my mind telling me I should have used the other property.

IMHO the difference between both properties should either be explained better - for folks like myself ;) - or we should consider merging them into serviceArea.

Or am I over-simplifying it by suggesting this?

@mfhepp
Copy link
Contributor

mfhepp commented Apr 6, 2015

Hmm. There is a difference, but I see the potential for making serviceArea a superproperty of both (but with a different name). eligibleRegion indicates the area to which you will be willing to deliver (for physical things) or in which the buying party resides (for services and other immaterial goods like software, music, ... availableAtOr from links to a point of sales from which you can obtain a good or service, e.g. a location from which you can rent a car, pick up a good, receive a haircut, etc.

Historically, the range of eligibleRegion was an ISO 3166 code, and that of availableAtOrFrom was a place. If we align the range, we could think about aligning the properties.

@mfhepp
Copy link
Contributor

mfhepp commented Apr 6, 2015

But also note that eligibleRegion is also used on gr:License and schema:DeliveryChargeSpecification. We need to double check dependencies and will likely break old data or applications. Still worth investigating.

@danbri danbri modified the milestones: 2015 Q2, 2015 Q1 Apr 17, 2015
@danbri danbri added schema.org vocab General top level tag for issues on the vocabulary For Steering Group Attention labels May 27, 2015
@danbri
Copy link
Contributor

danbri commented Sep 28, 2015

Ok, let's attend to eligibleRegion and availableAtOrFrom separately.

The "low hanging fruit" here is to fix the range of serviceArea, which is currently inappropriately tight. I will add Place, as well as GeoShape (since some service areas aren't name-able places, so it is clunky to force an intermediate Place/geo structure here).

@danbri
Copy link
Contributor

danbri commented Sep 28, 2015

ok see http://sdo-phobos.appspot.com/serviceArea

"Values expected to be one of these types: GeoShape, Place.
Used on these types: Organization, Service"

danbri pushed a commit that referenced this issue Sep 28, 2015
@vholland
Copy link
Contributor Author

+1

@danbri
Copy link
Contributor

danbri commented Sep 28, 2015

/cc @shankarnat @chaals @pmika @mfhepp @scor

@danbri
Copy link
Contributor

danbri commented Sep 28, 2015

In fixing this I discovered another cleanup issue: we also had areaServed on ContactPoint. I have marked it supersededBy serviceArea and added ContactPoint as a type for serviceAre - see #803 for details.

@pmika
Copy link
Collaborator

pmika commented Sep 28, 2015

+1

1 similar comment
@mfhepp
Copy link
Contributor

mfhepp commented Sep 28, 2015

+1

@danbri
Copy link
Contributor

danbri commented Sep 28, 2015

Just posted to #803:

"@rvguha just made the sensible point that it would be better (c.f. #803) to have a property name that can't be easily mistaken for a type name. Therefore I propose we flip the supersededBy relationship around, and adopt areaServed as a (slightly) less-nouny preferred name. Unless anyone disagrees I'll update the draft site accordingly, with areaServed taking on the work now done by serviceArea. Currently we have both of these properties in parallel unrelated use, so one needs to be picked - I just think now I picked the wrong one."

Consequence here is that we continue as above, but consolidate around areaServed instead of serviceArea.

@danbri
Copy link
Contributor

danbri commented Sep 29, 2015

I have implemented the flip of serviceArea to areaServed (i.e. reversed the supersededBy relationship).

I have also made a pass through, declaring both eligibleRegion and availableAtOrFrom as sub-properties of the common broader areaServed property. The areaServed property list of associated types (domain and range) are amended accordingly. The definition is simply "The geographic area where a service or offered item is provided.".

@mfhepp 's account of the three properties' subtle differences I think justified their continuing distinct existence (and we could improve their descriptions to match). However it was painful that they were not even previous related to each other. I think having eligibleRegion and availableAtOrFrom as sub-properties makes sense. Note also that we have ineligibleRegion nearby, which remains untouched.

danbri added a commit that referenced this issue Sep 29, 2015
…Region, availableAtOrFrom; supersedes areaServed.

This cleanup gives named relationships to these 4 very very similar-sounding properties. The associated types on
areaServed now include all those used on its sub-properties.
@danbri
Copy link
Contributor

danbri commented Sep 29, 2015

@chaals
Copy link
Contributor

chaals commented Sep 29, 2015

Looks ok to me.

BTW, is there a way in the code to mark "associatedProperty" so that looking at eligibleRegion would lead you to ineligibleRegion?
/me hides

@danbri
Copy link
Contributor

danbri commented Sep 29, 2015

@chaals - I was thinking just the same. For now (like per-type deprecations) we have to write it out in the entity-escaped HTML description, which is both tedious and easy. In a way the types themselves are the real grouping construct for related properties, but whenever a property is usable on several types the assocation to related properties does become rather indirect. Let's add something.

@shankarnat
Copy link
Collaborator

+1

@danbri
Copy link
Contributor

danbri commented Sep 30, 2015

@chaals - I've cross referenced eligibleRegion and ineligibleRegion as suggested - thanks!

@scor
Copy link
Contributor

scor commented Sep 30, 2015

👍

@danbri
Copy link
Contributor

danbri commented Nov 6, 2015

Fixed in http://schema.org/docs/releases.html#v2.2 - thanks all

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

No branches or pull requests

8 participants