DO.COM.04 GeoLocation

The spdci:GeoLocation object represents a GooglePlus Code

Conversion of latitude and longitude to a plus code (including the bounding box and the centre); and Conversion of a plus code to the bounding box and centre.

Reference: OpenID Location Code

The following two requests show how to convert a latitude and longitude to a code, or how to get the geometry of a global code:

The GeoLocation object represents a structured entity encompassing the details and various components of a specific location.

Geo Location

Property Key	Data Type (and Restrictions)	Cardinality	Description
plus_code	Plus Code	0...1	contains the plus code information for the location.

Plus Code

The PlusCode object represents a structured entity encompassing the details and various components of a specific location.

Property Key	Data Type (and Restrictions)	Cardinality	Description
global_code	DT.COM.02 string	0...1	provides the global code for the latitude/longitude
geometry	Geometry	0...1	Contains the Geometry Object.

Geometry

The Geometry object represents a structured entity encompassing the details and various components of a specific location

Property Key	Data Type (and Restrictions)	Cardinality	Description
bounds	Bounds	0...1	provides the bounding box of the code, with the north east and south west coordinates.
location	DO.COM.05 GeoCoordinates	0...1	provides the centre of the bounding box.

Bounds

The Bounds object represents a structured entity encompassing the details and various components of a specific location

Property Key	Data Type (and Restrictions)	Cardinality	Description
northeast	DO.COM.05 GeoCoordinates	0...1	provides the centre of the bounding box.
southwest	DO.COM.05 GeoCoordinates	0...1	provides the centre of the bounding box.

Example of Use

Example

{
  "@context": {
   "spdci": "https://schema.spdci.org/common/v1/",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "schema": "http://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#"
  },
  "@id": "spdci:GeoLocation_1",
  "@type": "spdci:GeoLocation",
  "plus_code": {
    "global_code": "8FW4V900+",
    "geometry": {
      "@id": "geometry",
      "@type": "GeoLocation",
      "bounds": {
        "@id": "bounds",
        "@type": "geometry",
        "northeast": {
          "@id": "northeast",
          "@type": "GeoCoordinates",
          "latitude": 48.900000000000006,
          "longitude": 2.4000000000000057
        },
        "southwest": {
          "@id": "southwest",
          "@type": "GeoCoordinates",
          "latitude": 48.849999999999994,
          "longitude": 2.3499999999999943
        }
      },
      "location": {
        "@id": "location",
        "@type": "GeoCoordinates",
        "latitude": 48.875,
        "longitude": 2.375
      }
    }
  }
}

JSON-LD File on GitHub

https://github.com/spdci/schemas/blob/main/common/v1/GeoLocation.jsonld

{
  "@context": {
    "spdci": "https://schema.spdci.org/common/v1/",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "xsd": "http://www.w3.org/2001/XMLSchema#"
  },
  "@graph": [
    {
      "@id": "spdci:GeoLocation",
      "@type": "rdfs:Class",
      "rdfs:label": "Geo Location",
      "rdfs:subClassOf": [
        {
          "@type": "rdfs:Class",
          "rdfs:label": "Structured Entity"
        }
      ],
      "rdfs:property": [
        {
          "@id": "spdci:plus_code",
          "@type": "rdfs:Datatype",
          "rdfs:domain": "spdci:GeoLocation",
          "rdfs:comment": "contains the plus code information for the location.",
          "rdfs:range": {
            "@id": "rdfs:Class",
            "rdfs:property": [
              {
                "@id": "spdci:global_code",
                "@type": "rdfs:Datatype",
                "rdfs:domain": "spdci:plus_code",
                "rdfs:range": "xsd:string",
                "rdfs:comment": "provides the global code for the latitude/longitude"
              },
              {
                "@id": "spdci:geometry",
                "@type": "rdfs:Datatype",
                "rdfs:domain": "spdci:plus_code",
                "rdfs:comment": "Contains the Geometry Object.",
                "rdfs:range": {
                  "@id": "rdfs:Class",
                  "rdfs:property": [
                    {
                      "@id": "spdci:bounds",
                      "@type": "rdfs:Datatype",
                      "rdfs:domain": "spdci:geometry",
                      "rdfs:comment": "provides the bounding box of the code, with the north east and south west coordinates.",
                      "rdfs:range": {
                        "@id": "rdfs:Class",
                        "rdfs:property": [
                          {
                            "@id": "spdci:northeast",
                            "@type": "rdfs:Datatype",
                            "rdfs:domain": "spdci:bounds",
                            "rdfs:range": "spdci:GeoCoordinates",
                            "rdfs:comment": "provides the centre of the bounding box."
                          },
                          {
                            "@id": "spdci:southwest",
                            "@type": "rdfs:Datatype",
                            "rdfs:domain": "spdci:bounds",
                            "rdfs:range": "spdci:GeoCoordinates",
                            "rdfs:comment": "provides the centre of the bounding box."
                          }
                        ]
                      }
                    },
                    {
                      "@id": "spdci:location",
                      "@type": "rdfs:Datatype",
                      "rdfs:domain": "spdci:geometry",
                      "rdfs:range": "spdci:GeoCoordinates",
                      "rdfs:comment": "provides the centre of the bounding box."
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  ]
}