LogoLogo
WebsiteGitHubSlack
Common v1.0.0
Common v1.0.0
  • Digital Convergence Initiative (DCI)
    • About DCI
    • DCI Objective
    • Terminology
    • Acronyms
    • Licensing
  • Standards for Interoperability Interfaces
    • Structure & Versioning of the Standards
    • Naming Conventions
    • Common Assumptions
    • Common Exception Handling
    • Common Standards for Interoperability Interfaces
      • Process
        • PRS.COM.01 Standards Creation
      • Data
        • File Type: JSON-LD
        • Data Objects
          • DO.COM.01 Identifier
          • DO.COM.02 Name
          • DO.COM.03 Address
          • DO.COM.04 GeoLocation
          • DO.COM.05 GooglePlusCode
          • DO.COM.06 GeoShape
          • DO.COM.07 Place
        • Code Directory
          • CD.COM.01 identifier_type
          • CD.COM.02 marital_status
          • CD.COM.03 sex
          • CD.COM.04 vital_event
          • CD.COM.05 country
          • CD.COM.06 currency
          • CD.COM.07 relationship_type
          • CD.COM.08 ethnicity
          • CD.COM.09 nationality
          • CD.COM.10: functional_limitation _type
          • CD.COM.11: functional_limitations_level
          • CD.COM.12: payment_status
          • CD.COM.13: group_type
          • CD.COM.14: language_code
          • CD.COM.15: education_level
          • API specific
            • CD.COM.API.01 api_error_codes_common
            • CD.COM.API.02 api_error_codes_search_on_search
            • CD.COM.API.03 api_error_codes_subscribe_unsubscribe
            • CD.COM.API.04 api_error_codes_status_on_status
        • Data Types and Formats
          • DT.COM.01 object
          • DT.COM.02 string
            • Data Formats
              • DF.COM.STRING.01 date_time
              • DF.COM.STRING.02 phone_number
              • DF.COM.STRING.03 distance
              • DF.COM.STRING.04 country_code
              • DF.COM.STRING.05 geo_line
              • DF.COM.STRING.06 polygon
              • DF.COM.STRING.07 email
              • DF.COM.STRING.08 currency
          • DT.COM.03 integer
          • DT.COM.04 decimal
          • DT.COM.05 array
          • DT.COM.06 boolean
        • Data Governance
      • API
        • Design Principles
        • Versioning
        • Methods
          • API.COM.01.ASY Search (Async approach)
          • API.COM.01.SYN Search (Sync approach)
          • API.COM.02 Event Subscription
          • API.COM.03 Event Notification
          • API.COM.04.ASY Status (Async approach)
          • API.COM.04.SYN Status (Sync approach)
    • CRVS with SP-MIS Standards
    • Social Registry v1.0.0
    • Integrated Beneficiary Registry v1.0.0
    • Disability Registry v1.0.0.
    • Farmer Registry v1.0.0.
  • Resources
    • Website
    • GitHub
    • API Documentation
    • Discussion Forum
    • Guide Book
    • References
Powered by GitBook
On this page
  • Hint
  • GooglePlusCode
  • Plus_code
  • Geometry
  • Location
  • Bounds
  • Example of Use
  • Example

Was this helpful?

  1. Standards for Interoperability Interfaces
  2. Common Standards for Interoperability Interfaces
  3. Data
  4. Data Objects

DO.COM.05 GooglePlusCode

The spdci:GooglePlusCode object represents a GooglePlus Code.

Last updated 1 month ago

Was this helpful?

As GooglePlusCodes are frequently used to describe locations, this data object provides the representation of a location in the format of a , which can be embedded into the existing DO.COM.04 GeoLocation object.

For a more detailed reference, please look at the official here.

Reference: ,

Hint

The DCI Naming Conventions for the data objects used within this data object, which would usually be CamelCase, are neglected here, as it is a Google-specific format and conversion is intended to be made as easy as possible for the users. This means that, e.g. plus_code is snake_case (Google) instead of CamelCase (DCI). Also, longitude and latitude, which are represented as a full word in the DCI DO.COM.04 GeoLocation object (compliant with the FHIR standard ) are shortened to lng and lat here to comply with the Google spec for the same reason as above.

This is an exception for user convenience. The standard representation for a location within DCI is DO.COM.04 GeoLocation.

GooglePlusCode

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

Property Key
Data Type (and Restrictions)
Cardinality
Description

plus_code

0...1

Plus code information for the location

Plus_code

The plus_code 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

0...1

Global code for latitude/longitude

geometry

0...1

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

0...1

Bounding box of the code, with the north east and south west coordinates

location

0...1

Centre of the bounding box

Location

This representation of location is an exception and only used for thisGooglePlusCodedata object, as explained in the Hint

Property Key
Data Type (and Restrictions)
Cardinality
Description

lat

0...1

Latitude of a location

lng

0...1

Longitude of a location

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

0...1

Centre of the bounding box

southwest

0...1

Centre of the bounding box

Example of Use

Example

{
  "@context": {
   "spdci": "https://schema.spdci.org/common/v1/",
   "google-plus" : "https://github.com/google/open-location-code/wiki/Plus-codes-API",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "schema": "http://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#"
  },
  "@id": "spdci:GooglePlusCode1",
  "@type": "spdci:GooglePlusCode",
  "plus_code": {
    "@id": "plus_code1",
    "@type": "google-plus:plus_code",
    "global_code": "8FW4V900+",
    "geometry": {
      "@id": "geometry1",
      "@type": "google-plus:geometry",
      "bounds": {
        "@id": "bounds1",
        "@type": "google-plus:bounds",
        "northeast": {
          "@id": "northeast1",
          "@type": "google-plus:location",
          "lat": 48.900000000000006,
          "lng": 2.4000000000000057
        },
        "southwest": {
          "@id": "southwest1",
          "@type": "google-plus:location",
          "lat": 48.849999999999994,
          "lng": 2.3499999999999943
        }
      },
      "location": {
        "@id": "location1",
        "@type": "google-plus:location",
        "lat": 14.917312500000008,
        "lng": -23.511312500000017
      }
    }
  }
}

The standard representation of a location within DCI is DO.COM.04 GeoLocation(compliant with the FHIR standard ).

Google Plus Code
Google Documentation for Plus Codes
Google Plus Codes
Google Documentation for Plus Codes
Location - HL7 FHIR v5.0.0
Location - HL7 FHIR v5.0.0
DT.COM.02 string
DT.COM.04 decimal
DT.COM.04 decimal
Plus_code
Geometry
Bounds
Location
Location
Location