Class: Google::Apis::AddressvalidationV1::GoogleMapsAddressvalidationV1UspsData

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/addressvalidation_v1/classes.rb,
lib/google/apis/addressvalidation_v1/representations.rb,
lib/google/apis/addressvalidation_v1/representations.rb

Overview

The USPS data for the address. uspsData is not guaranteed to be fully populated for every US or PR address sent to the Address Validation API. It's recommended to integrate the backup address fields in the response if you utilize uspsData as the primary part of the response.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ GoogleMapsAddressvalidationV1UspsData

Returns a new instance of GoogleMapsAddressvalidationV1UspsData.



810
811
812
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 810

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#abbreviated_city ⇒ String

Abbreviated city. Corresponds to the JSON property abbreviatedCity

Returns:

  • (String) 


542
543
544
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 542

def abbreviated_city
  @abbreviated_city
end

#address_record_type ⇒ String

Type of the address record that matches the input address. * F: FIRM. This is a match to a Firm Record, which is the finest level of match available for an address. * G: GENERAL DELIVERY. This is a match to a General Delivery record. * H: BUILDING / APARTMENT. This is a match to a Building or Apartment record. * P: POST OFFICE BOX. This is a match to a Post Office Box.

  • R: RURAL ROUTE or HIGHWAY CONTRACT: This is a match to either a Rural Route or a Highway Contract record, both of which may have associated Box Number ranges. * S: STREET RECORD: This is a match to a Street record containing a valid primary number range. Corresponds to the JSON property addressRecordType

Returns:

  • (String) 


555
556
557
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 555

def address_record_type
  @address_record_type
end

#carrier_route ⇒ String

The carrier route code. A four character code consisting of a one letter prefix and a three digit route designator. Prefixes: * C: Carrier route (or city route) * R: Rural route * H: Highway Contract Route * B: Post Office Box Section * G: General delivery unit Corresponds to the JSON property carrierRoute

Returns:

  • (String) 


563
564
565
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 563

def carrier_route
  @carrier_route
end

#carrier_route_indicator ⇒ String

Carrier route rate sort indicator. Corresponds to the JSON property carrierRouteIndicator

Returns:

  • (String) 


568
569
570
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 568

def carrier_route_indicator
  @carrier_route_indicator
end

#cass_processed ⇒ Boolean Also known as: cass_processed?

Indicator that the request has been CASS processed. Corresponds to the JSON property cassProcessed

Returns:

  • (Boolean) 


573
574
575
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 573

def cass_processed
  @cass_processed
end

#county ⇒ String

County name. Corresponds to the JSON property county

Returns:

  • (String) 


579
580
581
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 579

def county
  @county
end

#default_address ⇒ Boolean Also known as: default_address?

Indicator that a default address was found, but more specific addresses exists. Corresponds to the JSON property defaultAddress

Returns:

  • (Boolean) 


584
585
586
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 584

def default_address
  @default_address
end

#delivery_point_check_digit ⇒ String

The delivery point check digit. This number is added to the end of the delivery_point_barcode for mechanically scanned mail. Adding all the digits of the delivery_point_barcode, delivery_point_check_digit, postal code, and ZIP+4 together should yield a number divisible by 10. Corresponds to the JSON property deliveryPointCheckDigit

Returns:

  • (String) 


593
594
595
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 593

def delivery_point_check_digit
  @delivery_point_check_digit
end

#delivery_point_code ⇒ String

2 digit delivery point code Corresponds to the JSON property deliveryPointCode

Returns:

  • (String) 


598
599
600
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 598

def delivery_point_code
  @delivery_point_code
end

#dpv_cmra ⇒ String

Indicates if the address is a CMRA (Commercial Mail Receiving Agency)--a private business receiving mail for clients. Returns a single character. * Y: The address is a CMRA * N: The address is not a CMRA Corresponds to the JSON property dpvCmra

Returns:

  • (String) 


605
606
607
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 605

def dpv_cmra
  @dpv_cmra
end

#dpv_confirmation ⇒ String

The possible values for DPV confirmation. Returns a single character or returns no value. * N: Primary and any secondary number information failed to DPV confirm. * D: Address was DPV confirmed for the primary number only, and the secondary number information was missing. * S: Address was DPV confirmed for the primary number only, and the secondary number information was present but not confirmed. * Y: Address was DPV confirmed for primary and any secondary numbers. * Empty: If the response does not contain a dpv_confirmation value, the address was not submitted for DPV confirmation. Corresponds to the JSON property dpvConfirmation

Returns:

  • (String) 


617
618
619
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 617

def dpv_confirmation
  @dpv_confirmation
end

#dpv_door_not_accessible ⇒ String

Flag indicates addresses where USPS cannot knock on a door to deliver mail. Returns a single character. * Y: The door is not accessible. * N: No indication the door is not accessible. Corresponds to the JSON property dpvDoorNotAccessible

Returns:

  • (String) 


624
625
626
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 624

def dpv_door_not_accessible
  @dpv_door_not_accessible
end

#dpv_drop ⇒ String

Flag indicates mail is delivered to a single receptable at a site. Returns a single character. * Y: The mail is delivered to a single receptable at a site. * N: The mail is not delivered to a single receptable at a site. Corresponds to the JSON property dpvDrop

Returns:

  • (String) 


631
632
633
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 631

def dpv_drop
  @dpv_drop
end

#dpv_enhanced_delivery_code ⇒ String

Indicates that more than one DPV return code is valid for the address. Returns a single character. * Y: Address was DPV confirmed for primary and any secondary numbers. * N: Primary and any secondary number information failed to DPV confirm. * S: Address was DPV confirmed for the primary number only, and the secondary number information was present but not confirmed, or a single trailing alpha on a primary number was dropped to make a DPV match and secondary information required. * D: Address was DPV confirmed for the primary number only, and the secondary number information was missing. * R: Address confirmed but assigned to phantom route R777 and R779 and USPS delivery is not provided. Corresponds to the JSON property dpvEnhancedDeliveryCode

Returns:

  • (String) 


645
646
647
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 645

def dpv_enhanced_delivery_code
  @dpv_enhanced_delivery_code
end

#dpv_footnote ⇒ String

The footnotes from delivery point validation. Multiple footnotes may be strung together in the same string. * AA: Input address matched to the ZIP+4 file * A1: Input address was not matched to the ZIP+4 file * BB: Matched to DPV ( all components) * CC: Secondary number not matched and not required * C1: Secondary number not matched but required * N1: High-rise address missing secondary number * M1: Primary number missing * M3: Primary number invalid

  • P1: Input address PO, RR or HC box number missing * P3: Input address PO, RR, or HC Box number invalid * F1: Input address matched to a military address * G1: Input address matched to a general delivery address * U1: Input address matched to a unique ZIP code * PB: Input address matched to PBSA record * RR: DPV confirmed address with PMB information * R1: DPV confirmed address without PMB information * R7: Carrier Route R777 or R779 record * IA: Informed Address identified * TA: Primary number matched by dropping a trailing alpha Corresponds to the JSON property dpvFootnote

Returns:

  • (String) 


663
664
665
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 663

def dpv_footnote
  @dpv_footnote
end

#dpv_no_secure_location ⇒ String

Flag indicates door is accessible, but package will not be left due to security concerns. Returns a single character. * Y: The package will not be left due to security concerns. * N: No indication the package will not be left due to security concerns. Corresponds to the JSON property dpvNoSecureLocation

Returns:

  • (String) 


671
672
673
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 671

def dpv_no_secure_location
  @dpv_no_secure_location
end

#dpv_no_stat ⇒ String

Is this a no stat address or an active address? No stat addresses are ones which are not continuously occupied or addresses that the USPS does not service. Returns a single character. * Y: The address is not active * N: The address is active Corresponds to the JSON property dpvNoStat

Returns:

  • (String) 


679
680
681
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 679

def dpv_no_stat
  @dpv_no_stat
end

#dpv_no_stat_reason_code ⇒ Fixnum

Indicates the NoStat type. Returns a reason code as int. * 1: IDA (Internal Drop Address) – Addresses that do not receive mail directly from the USPS but are delivered to a drop address that services them. * 2: CDS - Addresses that have not yet become deliverable. For example, a new subdivision where lots and primary numbers have been determined, but no structure exists yet for occupancy. * 3: Collision - Addresses that do not actually DPV confirm. * 4 : CMZ (College, Military and Other Types) - ZIP + 4 records USPS has incorporated into the data. * 5: Regular - Indicates addresses not receiving delivery and the addresses are not counted as possible deliveries. * 6: Secondary Required - The address requires secondary information. Corresponds to the JSON property dpvNoStatReasonCode

Returns:

  • (Fixnum) 


693
694
695
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 693

def dpv_no_stat_reason_code
  @dpv_no_stat_reason_code
end

#dpv_non_delivery_days ⇒ String

Flag indicates mail delivery is not performed every day of the week. Returns a single character. * Y: The mail delivery is not performed every day of the week. * N: No indication the mail delivery is not performed every day of the week. Corresponds to the JSON property dpvNonDeliveryDays

Returns:

  • (String) 


701
702
703
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 701

def dpv_non_delivery_days
  @dpv_non_delivery_days
end

#dpv_non_delivery_days_values ⇒ Fixnum

Integer identifying non-delivery days. It can be interrogated using bit flags: 0x40 – Sunday is a non-delivery day 0x20 – Monday is a non-delivery day 0x10 – Tuesday is a non-delivery day 0x08 – Wednesday is a non-delivery day 0x04 – Thursday is a non-delivery day 0x02 – Friday is a non-delivery day 0x01 – Saturday is a non-delivery day Corresponds to the JSON property dpvNonDeliveryDaysValues

Returns:

  • (Fixnum) 


710
711
712
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 710

def dpv_non_delivery_days_values
  @dpv_non_delivery_days_values
end

#dpv_pbsa ⇒ String

Indicates the address was matched to PBSA record. Returns a single character. * Y: The address was matched to PBSA record. * N: The address was not matched to PBSA record. Corresponds to the JSON property dpvPbsa

Returns:

  • (String) 


717
718
719
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 717

def dpv_pbsa
  @dpv_pbsa
end

#dpv_throwback ⇒ String

Indicates that mail is not delivered to the street address. Returns a single character. * Y: The mail is not delivered to the street address. * N: The mail is delivered to the street address. Corresponds to the JSON property dpvThrowback

Returns:

  • (String) 


724
725
726
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 724

def dpv_throwback
  @dpv_throwback
end

#dpv_vacant ⇒ String

Is this place vacant? Returns a single character. * Y: The address is vacant

  • N: The address is not vacant Corresponds to the JSON property dpvVacant

Returns:

  • (String) 


730
731
732
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 730

def dpv_vacant
  @dpv_vacant
end

#elot_flag ⇒ String

eLOT Ascending/Descending Flag (A/D). Corresponds to the JSON property elotFlag

Returns:

  • (String) 


735
736
737
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 735

def elot_flag
  @elot_flag
end

#elot_number ⇒ String

Enhanced Line of Travel (eLOT) number. Corresponds to the JSON property elotNumber

Returns:

  • (String) 


740
741
742
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 740

def elot_number
  @elot_number
end

#error_message ⇒ String

Error message for USPS data retrieval. This is populated when USPS processing is suspended because of the detection of artificially created addresses. The USPS data fields might not be populated when this error is present. Corresponds to the JSON property errorMessage

Returns:

  • (String) 


747
748
749
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 747

def error_message
  @error_message
end

#ews_no_match ⇒ Boolean Also known as: ews_no_match?

The delivery address is matchable, but the EWS file indicates that an exact match will be available soon. Corresponds to the JSON property ewsNoMatch

Returns:

  • (Boolean) 


753
754
755
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 753

def ews_no_match
  @ews_no_match
end

#fips_county_code ⇒ String

FIPS county code. Corresponds to the JSON property fipsCountyCode

Returns:

  • (String) 


759
760
761
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 759

def fips_county_code
  @fips_county_code
end

#lacs_link_indicator ⇒ String

LACSLink indicator. Corresponds to the JSON property lacsLinkIndicator

Returns:

  • (String) 


764
765
766
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 764

def lacs_link_indicator
  @lacs_link_indicator
end

#lacs_link_return_code ⇒ String

LACSLink return code. Corresponds to the JSON property lacsLinkReturnCode

Returns:

  • (String) 


769
770
771
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 769

def lacs_link_return_code
  @lacs_link_return_code
end

#pmb_designator ⇒ String

PMB (Private Mail Box) unit designator. Corresponds to the JSON property pmbDesignator

Returns:

  • (String) 


774
775
776
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 774

def pmb_designator
  @pmb_designator
end

#pmb_number ⇒ String

PMB (Private Mail Box) number; Corresponds to the JSON property pmbNumber

Returns:

  • (String) 


779
780
781
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 779

def pmb_number
  @pmb_number
end

#po_box_only_postal_code ⇒ Boolean Also known as: po_box_only_postal_code?

PO Box only postal code. Corresponds to the JSON property poBoxOnlyPostalCode

Returns:

  • (Boolean) 


784
785
786
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 784

def po_box_only_postal_code
  @po_box_only_postal_code
end

#post_office_city ⇒ String

Main post office city. Corresponds to the JSON property postOfficeCity

Returns:

  • (String) 


790
791
792
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 790

def post_office_city
  @post_office_city
end

#post_office_state ⇒ String

Main post office state. Corresponds to the JSON property postOfficeState

Returns:

  • (String) 


795
796
797
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 795

def post_office_state
  @post_office_state
end

#standardized_address ⇒ Google::Apis::AddressvalidationV1::GoogleMapsAddressvalidationV1UspsAddress

USPS representation of a US address. Corresponds to the JSON property standardizedAddress

Returns:



800
801
802
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 800

def standardized_address
  @standardized_address
end

#suitelink_footnote ⇒ String

Footnotes from matching a street or highrise record to suite information. If business name match is found, the secondary number is returned. * A: SuiteLink record match, business address improved. * 00: No match, business address is not improved. Corresponds to the JSON property suitelinkFootnote

Returns:

  • (String) 


808
809
810
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 808

def suitelink_footnote
  @suitelink_footnote
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
 
# File 'lib/google/apis/addressvalidation_v1/classes.rb', line 815

def update!(**args)
  @abbreviated_city = args[:abbreviated_city] if args.key?(:abbreviated_city)
  @address_record_type = args[:address_record_type] if args.key?(:address_record_type)
  @carrier_route = args[:carrier_route] if args.key?(:carrier_route)
  @carrier_route_indicator = args[:carrier_route_indicator] if args.key?(:carrier_route_indicator)
  @cass_processed = args[:cass_processed] if args.key?(:cass_processed)
  @county = args[:county] if args.key?(:county)
  @default_address = args[:default_address] if args.key?(:default_address)
  @delivery_point_check_digit = args[:delivery_point_check_digit] if args.key?(:delivery_point_check_digit)
  @delivery_point_code = args[:delivery_point_code] if args.key?(:delivery_point_code)
  @dpv_cmra = args[:dpv_cmra] if args.key?(:dpv_cmra)
  @dpv_confirmation = args[:dpv_confirmation] if args.key?(:dpv_confirmation)
  @dpv_door_not_accessible = args[:dpv_door_not_accessible] if args.key?(:dpv_door_not_accessible)
  @dpv_drop = args[:dpv_drop] if args.key?(:dpv_drop)
  @dpv_enhanced_delivery_code = args[:dpv_enhanced_delivery_code] if args.key?(:dpv_enhanced_delivery_code)
  @dpv_footnote = args[:dpv_footnote] if args.key?(:dpv_footnote)
  @dpv_no_secure_location = args[:dpv_no_secure_location] if args.key?(:dpv_no_secure_location)
  @dpv_no_stat = args[:dpv_no_stat] if args.key?(:dpv_no_stat)
  @dpv_no_stat_reason_code = args[:dpv_no_stat_reason_code] if args.key?(:dpv_no_stat_reason_code)
  @dpv_non_delivery_days = args[:dpv_non_delivery_days] if args.key?(:dpv_non_delivery_days)
  @dpv_non_delivery_days_values = args[:dpv_non_delivery_days_values] if args.key?(:dpv_non_delivery_days_values)
  @dpv_pbsa = args[:dpv_pbsa] if args.key?(:dpv_pbsa)
  @dpv_throwback = args[:dpv_throwback] if args.key?(:dpv_throwback)
  @dpv_vacant = args[:dpv_vacant] if args.key?(:dpv_vacant)
  @elot_flag = args[:elot_flag] if args.key?(:elot_flag)
  @elot_number = args[:elot_number] if args.key?(:elot_number)
  @error_message = args[:error_message] if args.key?(:error_message)
  @ews_no_match = args[:ews_no_match] if args.key?(:ews_no_match)
  @fips_county_code = args[:fips_county_code] if args.key?(:fips_county_code)
  @lacs_link_indicator = args[:lacs_link_indicator] if args.key?(:lacs_link_indicator)
  @lacs_link_return_code = args[:lacs_link_return_code] if args.key?(:lacs_link_return_code)
  @pmb_designator = args[:pmb_designator] if args.key?(:pmb_designator)
  @pmb_number = args[:pmb_number] if args.key?(:pmb_number)
  @po_box_only_postal_code = args[:po_box_only_postal_code] if args.key?(:po_box_only_postal_code)
  @post_office_city = args[:post_office_city] if args.key?(:post_office_city)
  @post_office_state = args[:post_office_state] if args.key?(:post_office_state)
  @standardized_address = args[:standardized_address] if args.key?(:standardized_address)
  @suitelink_footnote = args[:suitelink_footnote] if args.key?(:suitelink_footnote)
end