What should address.addressRegion be for UK ... - GitHub

addressRegion: The region in which locality is, and which is in the country. For example, California. The wording feels a little off (just in ... Skiptocontent {{message}} schemaorg / schemaorg Public Notifications Fork 810 Star 4.6k Code Issues 648 Pullrequests 25 Discussions Actions Projects 2 Wiki Security Insights More Code Issues Pullrequests Discussions Actions Projects Wiki Security Insights Newissue Haveaquestionaboutthisproject?SignupforafreeGitHubaccounttoopenanissueandcontactitsmaintainersandthecommunity. Pickausername EmailAddress Password SignupforGitHub Byclicking“SignupforGitHub”,youagreetoourtermsofserviceand privacystatement.We’lloccasionallysendyouaccountrelatedemails. AlreadyonGitHub? Signin toyouraccount Jumptobottom Whatshouldaddress.addressRegionbeforUKaddresses? #1848 Closed jamescridlandopenedthisissue Feb16,2018 ·39comments Closed Whatshouldaddress.addressRegionbeforUKaddresses? #1848 jamescridlandopenedthisissue Feb16,2018 ·39comments Assignees Labels no-issue-activity Comments Copylink jamescridland commented Feb16,2018 GoogleisgrumpyatmebecauseI'mmissingjobLocation.address.addressRegionfromthejobadvertisementsIhaveonmywebsite. http://schema.org/addressRegiongivesoneexample-"CA".ThisisanabbreviationforCalifornia,anAmericanstate,I'mpresuming;thoughitcouldjustaseasilybetheISOtwo-letterabbreviationfor"Canada".ThedocumentationisUS-centricandvague. IfaddressRegionisintendedtobeastate,provinceorprefecture,that'shelpfulforthosecountriesthathavethem. TheUKdoesn'thaveany"states".Itdoeshavecounties,buttheyaremainlyhistorical,andLondonisn'tinacounty.Nor,technically,isBristolorManchester,forexample.There'snothingIcanputthere. WhiletheUKdoesn'tnormallyaddanation("England","Wales","Scotland","NorthernIreland")toanaddress,isthiswhatisexpectedinthisfield? ThisisamandatoryfieldforajobLocation,yetGoogle'sgeodatadoesn'tincludea"nation"orahistoricalcounty-https://goo.gl/maps/was25WujcuT2isavisibleexampleofanaddressinLondon.WheremightIprogrammaticallygetthecorrectdatatosatisfyGoogle'srequirementforanaddressRegionforaUKaddress? Thetextwasupdatedsuccessfully,buttheseerrorswereencountered: 👍 1 Downloadreactedwiththumbsupemoji Copylink Contributor danbri commented Feb16,2018 Hi@jamescridland.Wecanonlyhandlethegeneralschemavocabularystructureissuehere.WhatGoogleorothercompaniesdowiththedataisbeyondthescopeoftheSchema.orgproject.Itsoundsliketheschemaisnotsufficientlyclearthoughsolet'skeepthisissueopenforthat... Sorry,somethingwentwrong. Copylink Author jamescridland commented Feb16,2018 Thanks,Dan.Withoutknowingwhatisexpectedinhere,itcouldbefilledwithgibberish-soitwouldbehelpfultounderstandwhatisintendedtobeinaddressRegion.IcanthengoandtalktoGoogle(somehow)totryandunderstandwhythisfieldismandatoryintheirspec;butrightnow,it'sabitopaqueastowhatshouldbethereinthefirstplace. Sorry,somethingwentwrong. Copylink Contributor danbri commented Feb18,2018 @jamescridland-that'safairrequest.I'mareasonableGooglecontactforthis(althoughitwouldhelpifyoupostedinhttps://productforums.google.com/forum/#!topicsearchin/webmasters/category$3Astructured-data%7Csort:relevance%7Cspell:false).Movinghousethisweekbutwillfollowup. Sorry,somethingwentwrong. danbri self-assignedthis Feb18,2018 Copylink Contributor danbri commented Feb18,2018 • edited FromaquickandunscientificlookatsomeWebdata,itseemssitesintheUSarepublishingstatecodeslike"CA"underaddressRegion,whereasintheUK,itisbeingfilledwithcounty(ish)names,bywhichImean"London"and"GreaterLondon"arebothusedtoo. Sorry,somethingwentwrong. Copylink WeaverStever commented Feb18,2018 • edited HereiswhatGooglesaysintheirlocalBusinessGuide: address.addressRegion|Text, required whereapplicableStateorprovince. https://developers.google.com/search/docs/data-types/local-business I'vefoundthatthefieldcanbeanemptystringwithoutraisingawarningorerrorontheSDTT. Sorry,somethingwentwrong. Copylink Author jamescridland commented Feb19,2018 Asasuggestion,then,couldIrequestthathttp://schema.org/addressRegionsuggeststhisfieldis: Forexample,thestate,province,Länderorprefecture:egCA,QLDorBayern ...sothatatleastit'sclearerthan"CA"(California/Canada). What'snotbeenveryhelpfulisnotknowingwhetherIshouldbeusinganabbreviationhereornot.Idon'tknowifthespecificationshouldsayso. IntheUK,itisbeingfilledwithcounty(ish)names,bywhichImean"London"and"GreaterLondon"arebothusedtoo. I'vesincediscoveredthatthisfieldisanalogoustoGooglePlaces"administrative_area_level_2",whichforUKaddresscontainsthingslike"GreaterLondon"or"CityofBristol".That'swhatI'mnowstickinginthere,anyway. 👍 2 iileiandthe-phoenixreactedwiththumbsupemoji Sorry,somethingwentwrong. Copylink WeaverStever commented Feb19,2018 @jamescridland Certainlyhavetoadmitthatthecurrentdescriptioninhttp://schema.org/addressRegionisextremelypoor.Abetterdescription? ProvinceStateCode https://gs1.org/voc/addressRegion TextspecifyingaprovinceorstateinabbreviatedformatforexampleNJ. Nearestschema.orgequivalent: Exactmatch:schema:addressRegion Foundhere:https://www.gs1.org/voc/addressRegion Sorry,somethingwentwrong. Copylink Contributor philbarker commented Feb19,2018 MightbeworthlookingatthePostOfficeadviceonaddressing.Towninthatcontextispostaltown,itdoesn'tnecessarilyimplythelocalityiswithintheboundaryofthetownasamunicipalauthority.Thereareexamplesofplaceswithapostaltownthatisinadifferentcounty[*] Bringingthisbacktoschema.org:itwouldhelpalotifthedefinitionsforaddressRegionandaddressLocalitysaidwhichwasbigger/whichwasmoreprecise.andhowtherelatedtostreetAddressandaddressCountry,e.g.addressLocality:thelocalitywithinwhichthestreetAddresslies,smallerthan/lessprecisethanaddressRegion. [*no,Ididn'tknowtherewerepostaladdressnerdseither,notuntilIfellintoconversationwithoneaboutthisacoupleofyearsago] Sorry,somethingwentwrong. Copylink ketanumretiya030 commented Feb20,2018 Youcaneusenfromhttp://schema.org/docs/gs.html alsochekhre:http://schema.org/addressRegion Sorry,somethingwentwrong. Copylink nickevansuk commented Mar11,2018 • edited FortheLondonexamplespecifically,we'vebeenadopting: "addressLocality"=Boroughname "addressRegion"="London"or"GreaterLondon" CertainlyagreethatthisisambiguousfortheUKandhascausedconfusionwithimplementers. CC@ldodds Sorry,somethingwentwrong. Copylink WeaverStever commented Mar11,2018 • edited TheGoogleSDTTdoesnotcomplainwhenthisfieldisempty,ornotincluded.InfactwhenyoudoaqueryofGooglePlaces,thearrayoffieldsrarelylineupwiththeirdescriptions. Notethefollowingfactsabouttheaddress_componentsarray: Thearrayofaddresscomponentsmaycontainmorecomponentsthantheformatted_address. Thearraydoesnotnecessarilyincludeallthepoliticalentitiesthatcontainanaddress,apartfromthoseincludedintheformatted_address.Toretrieveallthepoliticalentitiesthatcontainaspecificaddress,youshouldusereversegeocoding,passingthelatitude/longitudeoftheaddressasaparametertotherequest. Theformatoftheresponseisnotguaranteedtoremainthesamebetweenrequests.Inparticular,thenumberofaddress_componentsvariesbasedontheaddressrequestedandcanchangeovertimeforthesameaddress.Acomponentcanchangepositioninthearray.Thetypeofthecomponentcanchange.Aparticularcomponentmaybemissinginalaterresponse. https://developers.google.com/places/web-service/details ForEurope,IwouldsuggestthatMetropolitanAreascouldbeincludedinthedescriptionforvalidinput. https://en.wikipedia.org/wiki/List_of_metropolitan_areas_in_Europe ForUSaddresses,Ihaveinthepastusedthehttp://schema.org/containedInPlacetoassociateitwithaMetropolitanStatisticalArea,orsimilaralias. (Forinstance,amusicianisholdingaMusicEventinRedondoBeachCA,theeventmaybeofinteresttopeoplewithintheLosAngelesMetropolitanStatisticalArea,inadditiontoRedondoBeachandjustafewneighboringcities.) Sorry,somethingwentwrong. Copylink Author jamescridland commented Mar11,2018 Google'sSDTT*does*complainwhenyoufeeditajob,whichrequiresthis spuriousfieldasamandatory.Itdoesn'tactuallycheckthatthefield makessense. Withoutaclearstandardforuse,thisfieldispointless,sincesystems willhavenoknowledgeofwhattoreasonablyexpectinit.Sofar,a "correct"valueforSouthgate,apartofLondon,couldreasonablybe "England","GreaterLondon","Middlesex","Enfield"or"Boroughof Enfield",allofwhich,incidentally,don'tappearonacorrectly-addressed pieceofpostalmail. AllI'vereallyaskedforisbetterdocumentationthanitiscurrently, whichissimply"forexample,CA"-whichisUS-centricandconfusing (givenCAisthecountrycodeforCanada). OnMon.,12Mar.2018,08:04WeaverStever,***@***.***>wrote: TheGoogleSDTTdoesnotcomplainwhenthisfieldisempty,ornot included.InfactwhenyoudoaqueryofGooglePlaces,thearrayoffields rarelylineupwiththeirdescriptions. Notethefollowingfactsabouttheaddress_componentsarray: Thearrayofaddresscomponentsmaycontainmorecomponentsthanthe formatted_address. Thearraydoesnotnecessarilyincludeallthepoliticalentitiesthat containanaddress,apartfromthoseincludedintheformatted_address.To retrieveallthepoliticalentitiesthatcontainaspecificaddress,you shouldusereversegeocoding,passingthelatitude/longitudeoftheaddress asaparametertotherequest. Theformatoftheresponseisnotguaranteedtoremainthesamebetween requests.Inparticular,thenumberofaddress_componentsvariesbasedon theaddressrequestedandcanchangeovertimeforthesameaddress.*A componentcanchangepositioninthearray.Thetypeofthecomponentcan change.*Aparticularcomponentmaybemissinginalaterresponse. https://developers.google.com/places/web-service/details ForEurope,IwouldsuggestthatMetropolitanAreascouldbeincludedin thedescriptionforvalidinput. https://en.wikipedia.org/wiki/List_of_metropolitan_areas_in_Europe ForUSaddresses,Ihaveinthepastusedthe http://schema.org/containedInPlacetoassociateitwithaMetropolitan StatisticalArea ,orsimilar alias. (Forinstance,amusicianisholdinganMusicEventinRedondoBeachCA, theeventmaybeofinteresttopeoplewithintheLosAngelesMetropolitan StatisticalArea,inadditiontoRedondoBeachandjustafewneighboring cities.) — Youarereceivingthisbecauseyouwerementioned. Replytothisemaildirectly,viewitonGitHub , ormutethethread . -- *https://james.crid.land-getmyweeklyinternationalradiotrends newsletter *https://next.radio-theradioideasconference *https://podnews.net-dailynewsaboutpodcastingandon-demand *https://media.info-themediainformationwebsite Tel:+61447692743|UK:02071001811('tillmidday) Sorry,somethingwentwrong. Copylink WeaverStever commented Mar12,2018 • edited @jamescridland, AlittledeeperintotherabbitholeatGooglePlaces,Ibelievethatthey(SDTT)areexpecting"administrative_area_level_1"foraddressRegion. The(regions)typecollectioninstructsthePlacesservicetoreturnanyresultmatchingthefollowingtypes: locality sublocality postal_code country administrative_area_level_1 administrative_area_level_2 The(cities)typecollectioninstructsthePlacesservicetoreturnresultsthatmatchlocalityoradministrative_area_level_3. https://developers.google.com/places/web-service/supported_types#table2 ThereissomeJSONoutputonthispageshowingtheseTypes. "html_attributions":[], "result":{ "address_components":[ { "long_name":"5", "short_name":"5", "types":["floor"] }, { "long_name":"48", "short_name":"48", "types":["street_number"] }, { "long_name":"PirramaRoad", "short_name":"PirramaRd", "types":["route"] }, { "long_name":"Pyrmont", "short_name":"Pyrmont", "types":["locality","political"] }, { "long_name":"CounciloftheCityofSydney", "short_name":"Sydney", "types":["administrative_area_level_2","political"] }, { "long_name":"NewSouthWales", "short_name":"NSW", "types":["administrative_area_level_1","political"] }, { "long_name":"Australia", "short_name":"AU", "types":["country","political"] }, { "long_name":"2009", "short_name":"2009", "types":["postal_code"] } ], (shortenedforbrevity) https://developers.google.com/places/web-service/details ThisStackOverflowquestionindicatesthatwearelookingfor"administrative_area_level_1"inschemaaddressRegion. FortheUSthe"administrative_area_level_1"isthestate,inCanadaitistheprovincesandterritories.Itappearsthatthesearecalled"AdministrativeDivisions"inWikipedia. https://en.wikipedia.org/wiki/List_of_administrative_divisions_by_country (Referencingthe"First-level"columninthetable.) Solet'swriteaproposeddescriptionforthehttp://schema.org/addressRegionproperty. TheUnitedNation's,First-levelpoliticalregionorequivelent.InCanada,theFirst-levelpoliticalregionsaretheprovincesandterritories,intheU.S.theseregionsarethe50states(andsomeadditional).Formoreinformationsee:https://en.wikipedia.org/wiki/List_of_administrative_divisions_by_country Sorry,somethingwentwrong. Copylink Author jamescridland commented Mar12,2018 That'saprettygreatdescription.Youmightwishtoalsoclarifywhether "CA"isacceptableorwhetheritshouldbe"California"(or"QLD"or "Queensland"). :) //j … On12March2018at15:16,WeaverStever***@***.***>wrote: @jamescridland, AlittledeeperintotherabbitholeatGooglePlaces,Ibelievethatthey (SDTT)areexpecting"administrative_area_level_1"foraddressRegion. The(regions)typecollectioninstructsthePlacesservicetoreturnany resultmatchingthefollowingtypes: locality sublocality postal_code country administrative_area_level_1 administrative_area_level_2 The(cities)typecollectioninstructsthePlacesservicetoreturn resultsthatmatchlocalityoradministrative_area_level_3. https://developers.google.com/places/web-service/supported_types#table2 ThereissomeJSONoutputonthispageshowingtheseTypes. "html_attributions":[], "result":{ "address_components":[ { "long_name":"5", "short_name":"5", "types":["floor"] }, { "long_name":"48", "short_name":"48", "types":["street_number"] }, { "long_name":"PirramaRoad", "short_name":"PirramaRd", "types":["route"] }, { "long_name":"Pyrmont", "short_name":"Pyrmont", "types":["locality","political"] }, { "long_name":"CounciloftheCityofSydney", "short_name":"Sydney", "types":["administrative_area_level_2","political"] }, { "long_name":"NewSouthWales", "short_name":"NSW", "types":["administrative_area_level_1","political"] }, { "long_name":"Australia", "short_name":"AU", "types":["country","political"] }, { "long_name":"2009", "short_name":"2009", "types":["postal_code"] } ], (shortenedforbrevity) https://developers.google.com/places/web-service/details ThisStackOverflowquestion indicatesthatwearelookingfor"administrative_area_level_1"inschema addressRegion. FortheUSthe"administrative_area_level_1"isthestate,inCanadaitis theprovincesandterritories.Itappearsthatthesearecalled "AdministrativeDivisions"inWikipedia. https://en.wikipedia.org/wiki/List_of_administrative_divisions_by_country (Referencingthe"First-level"columninthetable.) Solet'swriteadescriptionforthehttp://schema.org/addressRegion property. TheUnitedNation's,First-levelpoliticalregionorequivelent.In Canada,theFirst-levelpoliticalregionsaretheprovincesand territories,intheU.S.theseregionsarethe50states(andsome additional).Formoreinformationsee:https://en.wikipedia.org/wiki/ List_of_administrative_divisions_by_country — Youarereceivingthisbecauseyouwerementioned. Replytothisemaildirectly,viewitonGitHub , ormutethethread . -- Tel:+61447692743|UKtel:02071001811('tillmidday) AmazinglyBrilliantPtyLtd|ABN30612913514 Sorry,somethingwentwrong. Copylink WeaverStever commented Mar12,2018 • edited @jamescridland Aquicklookbackatthislinkconfirmsthatweareindeedsupplyingtheabbreviatedversion.AKAtheshort_nameinGooglePlaces.https://www.gs1.org/voc/addressRegion TextspecifyingaprovinceorstateinabbreviatedformatforexampleNJ. TheUnitedNation's,First-levelpoliticalregionorequivalent. InCanada,theFirst-levelpoliticalregionsaretheprovincesandterritories,intheU.S.theseregionsarethe50states(andsomeadditional).Forothercountriesandmoreinformationsee:https://en.wikipedia.org/wiki/List_of_administrative_divisions_by_country Sorry,somethingwentwrong. Copylink WeaverStever commented Mar12,2018 @danbri Wouldyoureadovertheselastfiveorsixposts?ThedescriptioninaddressRegionisverypoorandwe'veproposedsomeverbiage. Thanks Sorry,somethingwentwrong. Copylink LeodanDesign commented Apr22,2018 • edited I'vejustbeenworkingonco-ordinatingadataschemaonaWordPressbusinessdirectory,usingGooglePlacesAPItopullinvalidateddata,andthenuseittooutputtheJSON-LDschemaforrichsnippets.Theproblemisn'tthatGoogleisn'tclear,butthattheUKseemtobedifferent.ForUKaddressestheschemaappearstobelocality->village/urbandistrict,postal_town->town/city,administrative_area_2->county,administrative_area_1->country(E,S,W,NI),country->kingdom(UK).However,fornon-UKcompanies(US&FinlandsofarandIguessnormalcountriesinsteadofKingdoms,itappearstobeneighborhood->urbandistrict,locality->town/city,administrative_area_1->state,country->country. It'sworthgettingafreeAPIkeyandexperimentingwithPlacesAPItoseehowthingsarereturned.It'salsointerestingtonotethatthePlacesAPIreturnsaHTMLelementinstringformusesspanwithclassnamestostandardiselocality,region,country,postcode.Intheendtoconfirmthedatavalidation,formyprojectIusedjQuerytorendertheHTMLandthenpullofthecontentfromtheindividualspans-itmadethingsabitmorestandardandpredictable,andhelpedmegetmyheadaroundhowthedatafittedintotheaddressschemaformat. Also,withregardsplacenames,theAPIreturnsbothshortandlongnames,ie.UnitedKingdomandUK,DCandDistrictofColumbia,althoughrenderstheshortversionmostcommonly.Alsodoesthesameforotherfields,e.g.PennsylvaniaAvenueNorthwest&PennsylvaniaAveNW. --Edit-- GooglePlacesusestheadrmicroformatintheAPIreturndata https://developers.google.com/places/web-service/details#PlaceDetailsResults http://microformats.org/wiki/adr#Property_List Sorry,somethingwentwrong. Copylink WeaverStever commented Apr23,2018 @LeodanDesign HereiswhatgooglehastosayabouttheAddressArray: Theformatoftheresponseisnotguaranteedtoremainthesamebetweenrequests.Inparticular,thenumberofaddress_componentsvariesbasedontheaddressrequestedandcanchangeovertimeforthesameaddress.Acomponentcanchangepositioninthearray.Thetypeofthecomponentcanchange.Aparticularcomponentmaybemissinginalaterresponse. AsfortheaddressRegion,intheUSandCanadatheyarethestatesandprovinces.Forothercountries,IbelievethataddressRegionacceptsadministrative_area_level_1(Evidenceinmyearlierposts) Theadministrativeareasarelistedhere. https://en.wikipedia.org/wiki/List_of_administrative_divisions_by_country Asforyourproject,IhavedonesomethingsimilarforlocalBusiness.IneedtorevisithowIhandledaddresses,IthinkIparsedtheformattedaddress. https://places.parkingbeater.com/ Sorry,somethingwentwrong. Copylink WeaverStever commented Apr23,2018 P.S. AsIrecallfromarelatedproject,Ifoundthattheaddresscomponentsarraywereunreliable.IthinkoneofthebadexampleswastheMicrosoftTheaterinLosAngeles. Sorry,somethingwentwrong. Copylink Download commented Sep3,2018 IjustwantedtoletyouguysknowthatIfoundthisissuebecause!hadexactlythesamequestionastheOP(tryingtogetaUKaddresstofit). ThedocumentationreallyneedsachangebutthereseemtobemanysmallissueslikethesenotgettingfixedformonthssoIwonderifpeopleareactuallystillworkingonthis.Alsothesheernumberofopenissuesisdaunting.TheGoogleStructuredDataTestingToolalsohasmanyissues.Itmakesitveryhardforimplementerstodoitcorrectly. Sorry,somethingwentwrong. Copylink andrewmartinuk commented Sep10,2018 I'veoptedtouseaddressRegionalongsideCounty(e.g.Cambridgeshire),althoughIdidoriginallystartoffusingitforCountryinstead(e.g.England)butfeltitgavelittlevalue,asCountryreallyneededtobeUnitedKingdom,andUKaddressesrarelybotherincludingEnglandandUnitedKingdom(fornow). Sorry,somethingwentwrong. Copylink Author jamescridland commented Sep11,2018 It'sdisappointingthatnobodyhasbeenbotheredtoupdatetheambiguousdocumentationaftersolong.@danbri-couldIatleastaskthatthedocumentationisupdatedwithmoreexamplesthanjust"CA",whichcouldjustaseasilybeCanadaasCalifornia?Or,ifthisprojectisinmaintenance-onlymode,couldyoubehonestandsayso?grumpyjamesisgrumpy @andrewmartinukBecautiousnottoconfuseschema'srequirementwithaRoyalMailaddressrequirement.(ForRoyalMailaddresses,countiesshouldneverbeused.)Google/Schemaneeds,weirdly,moredetailthanactuallyexistsinpostaladdresses. Sorry,somethingwentwrong. Copylink Download commented Sep20,2018 Google/Schemaneeds,weirdly,moredetailthanactuallyexistsinpostaladdresses. Yes.AndI'dsaythat'snotjustweird,it'swrong. Schema.orgshouldletmedescribewhatisonmywebsite.NottellmewhatinfoIshouldputonmywebsiteinthefirstplace.Soallthesefieldsshouldbeoptionalandthevalidatorshouldnotcomplain. Sorry,somethingwentwrong. Copylink Contributor philbarker commented Sep24,2018 • edited Google/Schemaneeds,weirdly,moredetailthanactuallyexistsinpostaladdresses. Moreaccurately:Googleneeds,weirdly,moredetailinschema.orgformatthanexistsinpostaladdresses. Seethesecondpostinthisthread,&immediatereplies,forwhatcanbeaddressedhere(i.e.issueswithschema.orgsuchasguidance,butnotGoogle'srequirements). Sorry,somethingwentwrong. Copylink Author jamescridland commented Sep24,2018 Phil-therearetwoissueshere. Theawful,US-centric,confusingdocumentationbyschema.orgthatgivesnoclarificationofwhatshouldgoinanaddressoutsidetheUS. Google's(incorrect?)requirements. Wecanallhelpfix#1.Iwishsomeoneatschemawouldrunwiththisball.Currentlyitseemsasifnobodyintheprojectisinterested.(Ican'teventellwhetheranyone'sworkingonschemaatall). Sorry,somethingwentwrong. Copylink Download commented Sep27,2018 Ican'teventellwhetheranyone'sworkingonschemaatall Well,Ihavebeenmonitoringtheissuesforawhilenowandsmallchanges(suchasthisissue,whichbasicallysuggestsadocchangethatshouldbeimplementableinafewhours)aresimplynotpickedup. IbasicallyspelledoutthetextthatIthinkshouldgointhedocsinthisissue,butnothinghappens...IwouldmakeaPRifitwereclearwhattodobutIfoundnoguidance. Sorry,somethingwentwrong. Copylink Author jamescridland commented Sep27,2018 Yeah.It'sclearthatnobody'sworkingonthisprojectanymore.Ijustwish@danbriandotherswouldbehonest.Disappointing. 👎 1 danbrireactedwiththumbsdownemoji Sorry,somethingwentwrong. Copylink kmcconnell commented Sep27,2018 MaybesubmitaPR?https://github.com/schemaorg/schemaorg/blob/master/README.md Sorry,somethingwentwrong. philbarker addedacommit tophilbarker/schemaorg thatreferenced thisissue Sep27,2018 ClarifyingrelativesizesofregionsandlocalitiesinPostalAddresse… … f989131 …s.Forissueschemaorg#1848 philbarker mentionedthisissue Sep27,2018 ClarifyingrelativesizesofregionandlocalityinPostalAddress #2074 Merged Copylink Contributor philbarker commented Sep27,2018 I'veputinapullrequestthatIthinkwouldhelpeasesomeoftheconfusion @jamescridland feels. Idon'treallyseetheproblemaboutCApossiblybeingCanada:it'sclearlynotbecauseCanadaisacountryandaddressCountryexists. Ithinkthemainpointofthisissue,atleastthepartthatisrelevanttoschema.org,thatiscountry-specificguidanceonusingPostalAddressmightbebetteraddressedthroughthewikithanaddingtoalreadyover-loadedexamplessection. Sorry,somethingwentwrong. Copylink Contributor danbri commented Sep27,2018 Thanksfortheconcretesuggestion@philbarker Fromyourdraft,f989131 addressLocality:Thelocalityinwhichstreetaddressis,andwhichisintheregion.Forexample,MountainView. addressRegion:Theregioninwhichlocalityis,andwhichisinthecountry.Forexample,California. Thewordingfeelsalittleoff(justintermsoftheEnglish,missingacoupleof"the"smaybe?)butdoesthisfeellikeprogress,@jamescridlandetal? Philiscorrectthatwecan'taddtoomuchcountry-specificdetailintothedefinitions,butthebroadintentofthedefinitionsoughttobeclearfromtheircontentwithouttoomuchsearchingaroundelsewhere. /cc@ldodds Sorry,somethingwentwrong. Copylink Contributor ldodds commented Sep27,2018 • edited Echoing@nickevansukpointfromabove,we'vebeenencouraginguseofcounty/areaforaddressRegionaspartoftheOpenActiveproject,e.g: "addressLocality":"Bath", "addressRegion":"Somerset", Sorry,somethingwentwrong. Copylink edpars0ns commented Sep27,2018 Thiswillalwaysbeabitmessy. FromaUKperspectiveIwouldagreewith@ldodds@nickevansukthataddressRegionrepresentscounty-ThisismessybecauseforexamplemyhomecountyMiddlesexhasnotexistedfor50yearsbutisstillinwidespreaduseinsteadofthe"correct"GreaterLondon. Iwouldsuggestyouaretryingtoexpresshereissomeformofhierarchythatrepresentnotofficialpostalgeographybutcommonusage,andsomethingthatwillwiththenatureofaddresseshaveconsiderablevariationbetweencountries. Sorry,somethingwentwrong. Copylink Author jamescridland commented Sep27,2018 addressLocality:Thelocalityinwhichstreetaddressis,andwhichisintheregion.Forexample,MountainView. addressRegion:Theregioninwhichlocalityis,andwhichisinthecountry.Forexample,California. Thewordingfeelsalittleoff(justintermsoftheEnglish,missingacoupleof"the"smaybe?)butdoesthisfeellikeprogress,@jamescridlandetal? "California"or"CA"?Or,forthatmatter,"Bayside"or"SouthernCalifornia"or"EastSussex"? Sorry,somethingwentwrong. Copylink Author jamescridland commented Sep27,2018 Mysuggestionheremightbe: addressLocality:Thelocality(city,town,village)inwhichthestreetaddressis.Forexample,MountainView,Huddersfield,Kelowna addressRegion:Thestate,provinceorprefecturewherethelocalityis.Forexample,Queensland,California,Ontario,Kyoto.Standardabbreviationsmaybeused(CA,QLD). Weneedtobeclearwhatdatawe'reaskingfor;andalsotheformatofthatdata.Idon'tknowwhether"California"isacceptablehere,orwhetheritshouldbeCA.I'mabitconfusedwhetherit'sastateoracounty(MountainViewisinSantaClaraCounty-isn'tthattheregion?)Howcanwemakethisclearer? Myconcernisthat,forEnglishaddresses,we'reaskingfordatawhichdoesnotappearinpostaladdressesandisambiguous.FortheEnglishcityofHull(orKingstonuponHull,togiveititsfullname),thecorrectaddressRegioncouldbe"EastYorkshire","Humberside"ortheactuallycorrect"Hull",sinceitisn'tinacountyatall.Ialsohaveconcernthatthisdatamaynotbeavailableinanydatabase. Aspecificationthisambiguousisn'taspecification-andIcan'tseehowtherandomdatayoumightextractfromthisschemacanactuallybeusefulinareal-worldscenario. Thereispriorworkhere-theexcellentGeonamesdatabase.Here'sHull,forexample(whichisnotmarkedasbeinginacounty);AshgroveinQueensland,orMountainView. Sorry,somethingwentwrong. Copylink Contributor philbarker commented Sep28,2018 @danbriIseewhatyoumean.Willfix. @jamescridlandIamnotinfavouroftheextensionstothedefinitionsyougive. SometimesacitywillbetheaddressLocality,sometimesitwillbetheaddressRegion.Take10DowningSt,Westminster,LondonSW1A2AAforanexample.SometimesacitywillbeanaddressCountry:(MonacoorCittadelVaticano).Idon'tthinkanynumberofexamplesofwhatalocalityorregionmightbearegoingtohelp,theywillintroduceasmanyambiguitiesastheyresolve. UKpostaladdressesarestrange.They'remaybenottheonlystrangeaddressingsystemintheworld(IknowplacesinruralSpainwithnostreetnames),butmaybetheyaretheonlyoneswherethepostaladdressesaresodisjointfromtheadministrativelocationhierarchy.Loosedefinitionsworkwellwhentryingtofitdiversedata. Q:howdoesGeoNamesdealwithplaceswherethepostaltownisinadifferentcounty?E.g.ChirburyinShropshire(England)whichhasthepostaltownofMontgomery(Wales). Sorry,somethingwentwrong. Copylink Author jamescridland commented Sep28,2018 @philbarkerThanksforthecomments. Helpfultoremindmyselfthatthisdiscussionisabouthttp://schema.org/PostalAddressandnotaphysicaladdress. Theexampleyougive-"10DowningStreet,Westminster,LondonSW1A2AA"-isnotthepostaladdress.UsingtheRoyalMailchecker,thecorrectpostaladdressis10DowningStreet,LondonSW1A2AA.(Icanseethebenefitofknowingit'sinWestminster,butthisisnotthepostaladdress.) So,thisiscorrect,no? 10DowningStreet London, SW1A2AA Loosedefinitionsworkwellwhentryingtofitdiversedata. Ithinkthisisareligiousargument.Inthiscase,Idon'tagree.It'simportanttoensurethat,iftendifferentpeoplereadthedefinition,alltenpeoplewillputthesamedatainthesamefields.Andcurrentlythisisn'tthecase. Q:howdoesGeoNamesdealwithplaceswherethepostaltownisinadifferentcounty? Geonamesdoesn'tdopostaladdresses.That'sveryclear(thoughnotsoforSchema).ThecorrectansweristhatChirburyisinShropshire(thecounty),and"ChirburywithBrompton"(theparish). SowhatgoesinaSchemaaddresshere?ThepotteryshopinChirburyhasapostaladdressof"4,Shepherd'sYard,Chirbury,MontgomerySY156BH",yetaphysicaladdressof,Icanonlyassume,"4,Shepherd'sYard,Chirbury,ShropshireSY156BH". Does"Montgomery"(whichisapostaltown,andnottheadministrativearea)gointoaddressRegion?Ifwecanworkoutthiscase,itwouldreallyhelpus,Ithink. Sorry,somethingwentwrong. Copylink Contributor philbarker commented Sep28,2018 @jamescridlandIthinkforconsistencyIwouldalwaysputthepostaltownintheaddressRegion(andthinkoftheaddressLocalityasbeingintheareaservedbyit).So 10DowningStreet , London SW1A2AA and 4,Shepherd'sYard Chirbury, Montgomery SY156BH UsingPostalAddresstodescribethephysicaladdresswouldputShropshireinaddressRegion,as@ldodds&codo(andyesthisdoesleadtoodditieswhereBathcouldbethevalueofanaddressLocalityforaphysicaladdressinSomersetandthevalueofaddressRegionforapostaladdress,butthisisbecauseUKpostaladdressesareodd).Thisfitswith@danbri'scommentofseeingaddressRegion"beingfilledwithcounty(ish)names,bywhichImean"London"and"GreaterLondon"arebothusedtoo."SoIthinkthisisconsistentwithwhatDanseesandLeighsuggests. Hopethishelps,butIthinkI'vereachedthelimitofmyknowledgeaboutandinterestinthistopic,IfthepullrequestIsentclosesthisissue,thenthat'sgreat,butforgivemeifIduckoutnow. Sorry,somethingwentwrong. Copylink WeaverStever commented Sep30,2018 • edited FromGoogleMaps countryindicatesthenationalpoliticalentity,andistypicallythehighestordertypereturnedbytheGeocoder. administrative_area_level_1indicatesafirst-ordercivilentitybelowthecountrylevel.WithintheUnitedStates,theseadministrativelevelsarestates.Notallnationsexhibittheseadministrativelevels.Inmostcases,administrative_area_level_1shortnameswillcloselymatchISO3166-2subdivisionsandotherwidelycirculatedlists;howeverthisisnotguaranteedasourgeocodingresultsarebasedonavarietyofsignalsandlocationdata. administrative_area_level_2indicatesasecond-ordercivilentitybelowthecountrylevel.WithintheUnitedStates,theseadministrativelevelsarecounties.Notallnationsexhibittheseadministrativelevels. administrative_area_level_3indicatesathird-ordercivilentitybelowthecountrylevel.Thistypeindicatesaminorcivildivision.Notallnationsexhibittheseadministrativelevels. administrative_area_level_4indicatesafourth-ordercivilentitybelowthecountrylevel.Thistypeindicatesaminorcivildivision.Notallnationsexhibittheseadministrativelevels. administrative_area_level_5indicatesafifth-ordercivilentitybelowthecountrylevel.Thistypeindicatesaminorcivildivision.Notallnationsexhibittheseadministrativelevels. Wikipedia:Listofadministrativedivisionsbycountry I'vepostedsomeotherdocumentationearlierinthisthreadthatsuggestadministrative_area_level_1oradministrative_area_level_2couldbeappropriateforaddressRegionincountriesnotdelimitedbystate. Sorry,somethingwentwrong. Copylink github-actions bot commented Jul17,2020 ThisissueisbeingtaggedasStaleduetoinactivity. Sorry,somethingwentwrong. github-actions bot added the no-issue-activity label Jul17,2020 github-actions bot closedthisascompleted Jul25,2020 siuc-nate mentionedthisissue Nov16,2020 Addapropertytocapturesub-regions CredentialEngine/Schema-Development#739 Closed Signupforfree tojointhisconversationonGitHub. Alreadyhaveanaccount? Signintocomment Assignees danbri Labels no-issue-activity Projects Noneyet Milestone Nomilestone Development Nobranchesorpullrequests 12participants Youcan’tperformthatactionatthistime. Yousignedinwithanothertaborwindow.Reloadtorefreshyoursession. Yousignedoutinanothertaborwindow.Reloadtorefreshyoursession.