Class: Google::Apis::PartnersV2::Location
- Inherits:
-
Object
- Object
- Google::Apis::PartnersV2::Location
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- generated/google/apis/partners_v2/classes.rb,
generated/google/apis/partners_v2/representations.rb,
generated/google/apis/partners_v2/representations.rb
Overview
A location with address and geographic coordinates. May optionally contain a detailed (multi-field) version of the address.
Instance Attribute Summary collapse
-
#address ⇒ String
The single string version of the address.
-
#address_line ⇒ Array<String>
The following address lines represent the most specific part of any address.
-
#administrative_area ⇒ String
Top-level administrative subdivision of this country.
-
#dependent_locality ⇒ String
Dependent locality or sublocality.
-
#language_code ⇒ String
Language code of the address.
-
#lat_lng ⇒ Google::Apis::PartnersV2::LatLng
An object representing a latitude/longitude pair.
-
#locality ⇒ String
Generally refers to the city/town portion of an address.
-
#postal_code ⇒ String
Values are frequently alphanumeric.
-
#region_code ⇒ String
CLDR (Common Locale Data Repository) region code .
-
#sorting_code ⇒ String
Use of this code is very country-specific, but will refer to a secondary classification code for sorting mail.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Location
constructor
A new instance of Location.
-
#update!(**args) ⇒ Object
Update properties of this object.
Methods included from Core::JsonObjectSupport
Methods included from Core::Hashable
Constructor Details
#initialize(**args) ⇒ Location
Returns a new instance of Location
178 179 180 |
# File 'generated/google/apis/partners_v2/classes.rb', line 178 def initialize(**args) update!(**args) end |
Instance Attribute Details
#address ⇒ String
The single string version of the address.
Corresponds to the JSON property address
154 155 156 |
# File 'generated/google/apis/partners_v2/classes.rb', line 154 def address @address end |
#address_line ⇒ Array<String>
The following address lines represent the most specific part of any
address.
Corresponds to the JSON property addressLine
176 177 178 |
# File 'generated/google/apis/partners_v2/classes.rb', line 176 def address_line @address_line end |
#administrative_area ⇒ String
Top-level administrative subdivision of this country.
Corresponds to the JSON property administrativeArea
92 93 94 |
# File 'generated/google/apis/partners_v2/classes.rb', line 92 def administrative_area @administrative_area end |
#dependent_locality ⇒ String
Dependent locality or sublocality. Used for UK dependent localities, or
neighborhoods or boroughs in other locations.
Corresponds to the JSON property dependentLocality
149 150 151 |
# File 'generated/google/apis/partners_v2/classes.rb', line 149 def dependent_locality @dependent_locality end |
#language_code ⇒ String
Language code of the address. Should be in BCP 47 format.
Corresponds to the JSON property languageCode
170 171 172 |
# File 'generated/google/apis/partners_v2/classes.rb', line 170 def language_code @language_code end |
#lat_lng ⇒ Google::Apis::PartnersV2::LatLng
An object representing a latitude/longitude pair. This is expressed as a pair
of doubles representing degrees latitude and degrees longitude. Unless
specified otherwise, this must conform to the
WGS84
standard. Values must be within normalized ranges.
Example of normalization code in Python:
def NormalizeLongitude(longitude):
"""Wraps decimal degrees longitude to [-180.0, 180.0]."""
q, r = divmod(longitude, 360.0)
if r > 180.0 or (r == 180.0 and q <= -1.0):
return r - 360.0
return r
def NormalizeLatLng(latitude, longitude):
"""Wraps decimal degrees latitude and longitude to
[-90.0, 90.0] and [-180.0, 180.0], respectively."""
r = latitude % 360.0
if r <= 90.0:
return r, NormalizeLongitude(longitude)
elif r >= 270.0:
return r - 360, NormalizeLongitude(longitude)
else:
return 180 - r, NormalizeLongitude(longitude + 180.0)
assert 180.0 == NormalizeLongitude(180.0)
assert -180.0 == NormalizeLongitude(-180.0)
assert -179.0 == NormalizeLongitude(181.0)
assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)
assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)
assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)
assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)
assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)
assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)
assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)
assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)
assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)
assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
The code in logs/storage/validator/logs_validator_traits.cc treats this type
as if it were annotated as ST_LOCATION.
Corresponds to the JSON property latLng
138 139 140 |
# File 'generated/google/apis/partners_v2/classes.rb', line 138 def lat_lng @lat_lng end |
#locality ⇒ String
Generally refers to the city/town portion of an address.
Corresponds to the JSON property locality
97 98 99 |
# File 'generated/google/apis/partners_v2/classes.rb', line 97 def locality @locality end |
#postal_code ⇒ String
Values are frequently alphanumeric.
Corresponds to the JSON property postalCode
159 160 161 |
# File 'generated/google/apis/partners_v2/classes.rb', line 159 def postal_code @postal_code end |
#region_code ⇒ String
CLDR (Common Locale Data Repository) region code .
Corresponds to the JSON property regionCode
143 144 145 |
# File 'generated/google/apis/partners_v2/classes.rb', line 143 def region_code @region_code end |
#sorting_code ⇒ String
Use of this code is very country-specific, but will refer to a secondary
classification code for sorting mail.
Corresponds to the JSON property sortingCode
165 166 167 |
# File 'generated/google/apis/partners_v2/classes.rb', line 165 def sorting_code @sorting_code end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
183 184 185 186 187 188 189 190 191 192 193 194 |
# File 'generated/google/apis/partners_v2/classes.rb', line 183 def update!(**args) @administrative_area = args[:administrative_area] if args.key?(:administrative_area) @locality = args[:locality] if args.key?(:locality) @lat_lng = args[:lat_lng] if args.key?(:lat_lng) @region_code = args[:region_code] if args.key?(:region_code) @dependent_locality = args[:dependent_locality] if args.key?(:dependent_locality) @address = args[:address] if args.key?(:address) @postal_code = args[:postal_code] if args.key?(:postal_code) @sorting_code = args[:sorting_code] if args.key?(:sorting_code) @language_code = args[:language_code] if args.key?(:language_code) @address_line = args[:address_line] if args.key?(:address_line) end |