googleapis-common-protos-types 1.0.2 → 1.18.0

data/lib/google/type/month_pb.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/type/month.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x17google/type/month.proto\x12\x0bgoogle.type*\xb0\x01\n\x05Month\x12\x15\n\x11MONTH_UNSPECIFIED\x10\x00\x12\x0b\n\x07JANUARY\x10\x01\x12\x0c\n\x08\x46\x45\x42RUARY\x10\x02\x12\t\n\x05MARCH\x10\x03\x12\t\n\x05\x41PRIL\x10\x04\x12\x07\n\x03MAY\x10\x05\x12\x08\n\x04JUNE\x10\x06\x12\x08\n\x04JULY\x10\x07\x12\n\n\x06\x41UGUST\x10\x08\x12\r\n\tSEPTEMBER\x10\t\x12\x0b\n\x07OCTOBER\x10\n\x12\x0c\n\x08NOVEMBER\x10\x0b\x12\x0c\n\x08\x44\x45\x43\x45MBER\x10\x0c\x42]\n\x0f\x63om.google.typeB\nMonthProtoP\x01Z6google.golang.org/genproto/googleapis/type/month;month\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Type
+    Month = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.Month").enummodule
+  end
+end
+
+#### Source proto file: google/type/month.proto ####
+#
+# // Copyright 2024 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option go_package = "google.golang.org/genproto/googleapis/type/month;month";
+# option java_multiple_files = true;
+# option java_outer_classname = "MonthProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents a month in the Gregorian calendar.
+# enum Month {
+#   // The unspecified month.
+#   MONTH_UNSPECIFIED = 0;
+#
+#   // The month of January.
+#   JANUARY = 1;
+#
+#   // The month of February.
+#   FEBRUARY = 2;
+#
+#   // The month of March.
+#   MARCH = 3;
+#
+#   // The month of April.
+#   APRIL = 4;
+#
+#   // The month of May.
+#   MAY = 5;
+#
+#   // The month of June.
+#   JUNE = 6;
+#
+#   // The month of July.
+#   JULY = 7;
+#
+#   // The month of August.
+#   AUGUST = 8;
+#
+#   // The month of September.
+#   SEPTEMBER = 9;
+#
+#   // The month of October.
+#   OCTOBER = 10;
+#
+#   // The month of November.
+#   NOVEMBER = 11;
+#
+#   // The month of December.
+#   DECEMBER = 12;
+# }

data/lib/google/type/phone_number_pb.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/type/phone_number.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x1egoogle/type/phone_number.proto\x12\x0bgoogle.type\"\xab\x01\n\x0bPhoneNumber\x12\x15\n\x0b\x65\x31\x36\x34_number\x18\x01 \x01(\tH\x00\x12\x38\n\nshort_code\x18\x02 \x01(\x0b\x32\".google.type.PhoneNumber.ShortCodeH\x00\x12\x11\n\textension\x18\x03 \x01(\t\x1a\x30\n\tShortCode\x12\x13\n\x0bregion_code\x18\x01 \x01(\t\x12\x0e\n\x06number\x18\x02 \x01(\tB\x06\n\x04kindBt\n\x0f\x63om.google.typeB\x10PhoneNumberProtoP\x01ZDgoogle.golang.org/genproto/googleapis/type/phone_number;phone_number\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Type
+    PhoneNumber = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.PhoneNumber").msgclass
+    PhoneNumber::ShortCode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.PhoneNumber.ShortCode").msgclass
+  end
+end
+
+#### Source proto file: google/type/phone_number.proto ####
+#
+# // Copyright 2024 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/phone_number;phone_number";
+# option java_multiple_files = true;
+# option java_outer_classname = "PhoneNumberProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // An object representing a phone number, suitable as an API wire format.
+# //
+# // This representation:
+# //
+# //  - should not be used for locale-specific formatting of a phone number, such
+# //    as "+1 (650) 253-0000 ext. 123"
+# //
+# //  - is not designed for efficient storage
+# //  - may not be suitable for dialing - specialized libraries (see references)
+# //    should be used to parse the number for that purpose
+# //
+# // To do something meaningful with this number, such as format it for various
+# // use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first.
+# //
+# // For instance, in Java this would be:
+# //
+# //    com.google.type.PhoneNumber wireProto =
+# //        com.google.type.PhoneNumber.newBuilder().build();
+# //    com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber =
+# //        PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ");
+# //    if (!wireProto.getExtension().isEmpty()) {
+# //      phoneNumber.setExtension(wireProto.getExtension());
+# //    }
+# //
+# //  Reference(s):
+# //   - https://github.com/google/libphonenumber
+# message PhoneNumber {
+#   // An object representing a short code, which is a phone number that is
+#   // typically much shorter than regular phone numbers and can be used to
+#   // address messages in MMS and SMS systems, as well as for abbreviated dialing
+#   // (e.g. "Text 611 to see how many minutes you have remaining on your plan.").
+#   //
+#   // Short codes are restricted to a region and are not internationally
+#   // dialable, which means the same short code can exist in different regions,
+#   // with different usage and pricing, even if those regions share the same
+#   // country calling code (e.g. US and CA).
+#   message ShortCode {
+#     // Required. The BCP-47 region code of the location where calls to this
+#     // short code can be made, such as "US" and "BB".
+#     //
+#     // Reference(s):
+#     //  - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+#     string region_code = 1;
+#
+#     // Required. The short code digits, without a leading plus ('+') or country
+#     // calling code, e.g. "611".
+#     string number = 2;
+#   }
+#
+#   // Required.  Either a regular number, or a short code.  New fields may be
+#   // added to the oneof below in the future, so clients should ignore phone
+#   // numbers for which none of the fields they coded against are set.
+#   oneof kind {
+#     // The phone number, represented as a leading plus sign ('+'), followed by a
+#     // phone number that uses a relaxed ITU E.164 format consisting of the
+#     // country calling code (1 to 3 digits) and the subscriber number, with no
+#     // additional spaces or formatting, e.g.:
+#     //  - correct: "+15552220123"
+#     //  - incorrect: "+1 (555) 222-01234 x123".
+#     //
+#     // The ITU E.164 format limits the latter to 12 digits, but in practice not
+#     // all countries respect that, so we relax that restriction here.
+#     // National-only numbers are not allowed.
+#     //
+#     // References:
+#     //  - https://www.itu.int/rec/T-REC-E.164-201011-I
+#     //  - https://en.wikipedia.org/wiki/E.164.
+#     //  - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+#     string e164_number = 1;
+#
+#     // A short code.
+#     //
+#     // Reference(s):
+#     //  - https://en.wikipedia.org/wiki/Short_code
+#     ShortCode short_code = 2;
+#   }
+#
+#   // The phone number's extension. The extension is not standardized in ITU
+#   // recommendations, except for being defined as a series of numbers with a
+#   // maximum length of 40 digits. Other than digits, some other dialing
+#   // characters such as ',' (indicating a wait) or '#' may be stored here.
+#   //
+#   // Note that no regions currently use extensions with short codes, so this
+#   // field is normally only set in conjunction with an E.164 number. It is held
+#   // separately from the E.164 number to allow for short code extensions in the
+#   // future.
+#   string extension = 3;
+# }

data/lib/google/type/postal_address_pb.rb

@@ -1,26 +1,175 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/postal_address.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_message "google.type.PostalAddress" do
-    optional :revision, :int32, 1
-    optional :region_code, :string, 2
-    optional :language_code, :string, 3
-    optional :postal_code, :string, 4
-    optional :sorting_code, :string, 5
-    optional :administrative_area, :string, 6
-    optional :locality, :string, 7
-    optional :sublocality, :string, 8
-    repeated :address_lines, :string, 9
-    repeated :recipients, :string, 10
-    optional :organization, :string, 11
+
+descriptor_data = "\n google/type/postal_address.proto\x12\x0bgoogle.type\"\xfd\x01\n\rPostalAddress\x12\x10\n\x08revision\x18\x01 \x01(\x05\x12\x13\n\x0bregion_code\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t\x12\x13\n\x0bpostal_code\x18\x04 \x01(\t\x12\x14\n\x0csorting_code\x18\x05 \x01(\t\x12\x1b\n\x13\x61\x64ministrative_area\x18\x06 \x01(\t\x12\x10\n\x08locality\x18\x07 \x01(\t\x12\x13\n\x0bsublocality\x18\x08 \x01(\t\x12\x15\n\raddress_lines\x18\t \x03(\t\x12\x12\n\nrecipients\x18\n \x03(\t\x12\x14\n\x0corganization\x18\x0b \x01(\tBx\n\x0f\x63om.google.typeB\x12PostalAddressProtoP\x01ZFgoogle.golang.org/genproto/googleapis/type/postaladdress;postaladdress\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
   module Type
-    PostalAddress = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.PostalAddress").msgclass
+    PostalAddress = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.PostalAddress").msgclass
   end
 end
+
+#### Source proto file: google/type/postal_address.proto ####
+#
+# // Copyright 2024 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/postaladdress;postaladdress";
+# option java_multiple_files = true;
+# option java_outer_classname = "PostalAddressProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents a postal address, e.g. for postal delivery or payments addresses.
+# // Given a postal address, a postal service can deliver items to a premise, P.O.
+# // Box or similar.
+# // It is not intended to model geographical locations (roads, towns,
+# // mountains).
+# //
+# // In typical usage an address would be created via user input or from importing
+# // existing data, depending on the type of process.
+# //
+# // Advice on address input / editing:
+# //  - Use an i18n-ready address widget such as
+# //    https://github.com/google/libaddressinput)
+# // - Users should not be presented with UI elements for input or editing of
+# //   fields outside countries where that field is used.
+# //
+# // For more guidance on how to use this schema, please see:
+# // https://support.google.com/business/answer/6397478
+# message PostalAddress {
+#   // The schema revision of the `PostalAddress`. This must be set to 0, which is
+#   // the latest revision.
+#   //
+#   // All new revisions **must** be backward compatible with old revisions.
+#   int32 revision = 1;
+#
+#   // Required. CLDR region code of the country/region of the address. This
+#   // is never inferred and it is up to the user to ensure the value is
+#   // correct. See http://cldr.unicode.org/ and
+#   // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
+#   // for details. Example: "CH" for Switzerland.
+#   string region_code = 2;
+#
+#   // Optional. BCP-47 language code of the contents of this address (if
+#   // known). This is often the UI language of the input form or is expected
+#   // to match one of the languages used in the address' country/region, or their
+#   // transliterated equivalents.
+#   // This can affect formatting in certain countries, but is not critical
+#   // to the correctness of the data and will never affect any validation or
+#   // other non-formatting related operations.
+#   //
+#   // If this value is not known, it should be omitted (rather than specifying a
+#   // possibly incorrect default).
+#   //
+#   // Examples: "zh-Hant", "ja", "ja-Latn", "en".
+#   string language_code = 3;
+#
+#   // Optional. Postal code of the address. Not all countries use or require
+#   // postal codes to be present, but where they are used, they may trigger
+#   // additional validation with other parts of the address (e.g. state/zip
+#   // validation in the U.S.A.).
+#   string postal_code = 4;
+#
+#   // Optional. Additional, country-specific, sorting code. This is not used
+#   // in most regions. Where it is used, the value is either a string like
+#   // "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
+#   // alone, representing the "sector code" (Jamaica), "delivery area indicator"
+#   // (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
+#   string sorting_code = 5;
+#
+#   // Optional. Highest administrative subdivision which is used for postal
+#   // addresses of a country or region.
+#   // For example, this can be a state, a province, an oblast, or a prefecture.
+#   // Specifically, for Spain this is the province and not the autonomous
+#   // community (e.g. "Barcelona" and not "Catalonia").
+#   // Many countries don't use an administrative area in postal addresses. E.g.
+#   // in Switzerland this should be left unpopulated.
+#   string administrative_area = 6;
+#
+#   // Optional. Generally refers to the city/town portion of the address.
+#   // Examples: US city, IT comune, UK post town.
+#   // In regions of the world where localities are not well defined or do not fit
+#   // into this structure well, leave locality empty and use address_lines.
+#   string locality = 7;
+#
+#   // Optional. Sublocality of the address.
+#   // For example, this can be neighborhoods, boroughs, districts.
+#   string sublocality = 8;
+#
+#   // Unstructured address lines describing the lower levels of an address.
+#   //
+#   // Because values in address_lines do not have type information and may
+#   // sometimes contain multiple values in a single field (e.g.
+#   // "Austin, TX"), it is important that the line order is clear. The order of
+#   // address lines should be "envelope order" for the country/region of the
+#   // address. In places where this can vary (e.g. Japan), address_language is
+#   // used to make it explicit (e.g. "ja" for large-to-small ordering and
+#   // "ja-Latn" or "en" for small-to-large). This way, the most specific line of
+#   // an address can be selected based on the language.
+#   //
+#   // The minimum permitted structural representation of an address consists
+#   // of a region_code with all remaining information placed in the
+#   // address_lines. It would be possible to format such an address very
+#   // approximately without geocoding, but no semantic reasoning could be
+#   // made about any of the address components until it was at least
+#   // partially resolved.
+#   //
+#   // Creating an address only containing a region_code and address_lines, and
+#   // then geocoding is the recommended way to handle completely unstructured
+#   // addresses (as opposed to guessing which parts of the address should be
+#   // localities or administrative areas).
+#   repeated string address_lines = 9;
+#
+#   // Optional. The recipient at the address.
+#   // This field may, under certain circumstances, contain multiline information.
+#   // For example, it might contain "care of" information.
+#   repeated string recipients = 10;
+#
+#   // Optional. The name of the organization at the address.
+#   string organization = 11;
+# }

data/lib/google/type/quaternion_pb.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/type/quaternion.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x1cgoogle/type/quaternion.proto\x12\x0bgoogle.type\"8\n\nQuaternion\x12\t\n\x01x\x18\x01 \x01(\x01\x12\t\n\x01y\x18\x02 \x01(\x01\x12\t\n\x01z\x18\x03 \x01(\x01\x12\t\n\x01w\x18\x04 \x01(\x01\x42o\n\x0f\x63om.google.typeB\x0fQuaternionProtoP\x01Z@google.golang.org/genproto/googleapis/type/quaternion;quaternion\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Type
+    Quaternion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.Quaternion").msgclass
+  end
+end
+
+#### Source proto file: google/type/quaternion.proto ####
+#
+# // Copyright 2024 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/quaternion;quaternion";
+# option java_multiple_files = true;
+# option java_outer_classname = "QuaternionProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // A quaternion is defined as the quotient of two directed lines in a
+# // three-dimensional space or equivalently as the quotient of two Euclidean
+# // vectors (https://en.wikipedia.org/wiki/Quaternion).
+# //
+# // Quaternions are often used in calculations involving three-dimensional
+# // rotations (https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation),
+# // as they provide greater mathematical robustness by avoiding the gimbal lock
+# // problems that can be encountered when using Euler angles
+# // (https://en.wikipedia.org/wiki/Gimbal_lock).
+# //
+# // Quaternions are generally represented in this form:
+# //
+# //     w + xi + yj + zk
+# //
+# // where x, y, z, and w are real numbers, and i, j, and k are three imaginary
+# // numbers.
+# //
+# // Our naming choice `(x, y, z, w)` comes from the desire to avoid confusion for
+# // those interested in the geometric properties of the quaternion in the 3D
+# // Cartesian space. Other texts often use alternative names or subscripts, such
+# // as `(a, b, c, d)`, `(1, i, j, k)`, or `(0, 1, 2, 3)`, which are perhaps
+# // better suited for mathematical interpretations.
+# //
+# // To avoid any confusion, as well as to maintain compatibility with a large
+# // number of software libraries, the quaternions represented using the protocol
+# // buffer below *must* follow the Hamilton convention, which defines `ij = k`
+# // (i.e. a right-handed algebra), and therefore:
+# //
+# //     i^2 = j^2 = k^2 = ijk = −1
+# //     ij = −ji = k
+# //     jk = −kj = i
+# //     ki = −ik = j
+# //
+# // Please DO NOT use this to represent quaternions that follow the JPL
+# // convention, or any of the other quaternion flavors out there.
+# //
+# // Definitions:
+# //
+# //   - Quaternion norm (or magnitude): `sqrt(x^2 + y^2 + z^2 + w^2)`.
+# //   - Unit (or normalized) quaternion: a quaternion whose norm is 1.
+# //   - Pure quaternion: a quaternion whose scalar component (`w`) is 0.
+# //   - Rotation quaternion: a unit quaternion used to represent rotation.
+# //   - Orientation quaternion: a unit quaternion used to represent orientation.
+# //
+# // A quaternion can be normalized by dividing it by its norm. The resulting
+# // quaternion maintains the same direction, but has a norm of 1, i.e. it moves
+# // on the unit sphere. This is generally necessary for rotation and orientation
+# // quaternions, to avoid rounding errors:
+# // https://en.wikipedia.org/wiki/Rotation_formalisms_in_three_dimensions
+# //
+# // Note that `(x, y, z, w)` and `(-x, -y, -z, -w)` represent the same rotation,
+# // but normalization would be even more useful, e.g. for comparison purposes, if
+# // it would produce a unique representation. It is thus recommended that `w` be
+# // kept positive, which can be achieved by changing all the signs when `w` is
+# // negative.
+# //
+# message Quaternion {
+#   // The x component.
+#   double x = 1;
+#
+#   // The y component.
+#   double y = 2;
+#
+#   // The z component.
+#   double z = 3;
+#
+#   // The scalar component.
+#   double w = 4;
+# }