Updating component analysis and adding example.

Author: andrewjohnsonsmarty

Makefile

@@ -42,7 +42,7 @@ us_reverse_geo_api:
 	RUST_LOG=trace cargo run --example us_reverse_geo_api
 
 us_street_api:
-	RUST_LOG=trace cargo run --example us_street_api
+	RUST_LOG=trace cargo run --example us_street_api && RUST_LOG=trace cargo run --example us_street_component_analysis
 
 us_zipcode_api:
 	RUST_LOG=trace cargo run --example us_zipcode_api

smarty-rust-sdk/examples/us_street_component_analysis.rs

@@ -0,0 +1,47 @@
+extern crate serde_json;
+extern crate smarty_rust_sdk;
+extern crate tokio;
+
+use smarty_rust_sdk::us_street_api::lookup::{Lookup, MatchStrategy};
+
+use smarty_rust_sdk::sdk::authentication::SecretKeyCredential;
+use smarty_rust_sdk::sdk::batch::Batch;
+use smarty_rust_sdk::sdk::options::OptionsBuilder;
+use smarty_rust_sdk::us_street_api::client::USStreetAddressClient;
+use std::error::Error;
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn Error>> {
+    let lookup = Lookup {
+        street: "1600 Amphitheatre Pkwy".to_string(),
+        last_line: "Mountain View, CA".to_string(),
+        max_candidates: 10,
+        match_strategy: MatchStrategy::Enhanced, // Enhanced matching is required to return component analysis results.
+        ..Default::default()
+    };
+
+    let mut batch = Batch::default();
+    batch.push(lookup)?;
+
+    let authentication = SecretKeyCredential::new(
+        std::env::var("SMARTY_AUTH_ID").expect("Missing SMARTY_AUTH_ID env variable"),
+        std::env::var("SMARTY_AUTH_TOKEN").expect("Missing SMARTY_AUTH_TOKEN env variable"),
+    );
+
+    let options = OptionsBuilder::new(Some(authentication))
+        .with_component_analysis() // To add component analysis feature you need to specify when you create the options for the client.
+        .build();
+
+    let client = USStreetAddressClient::new(options)?;
+
+    client.send(&mut batch).await?;
+
+    // Here is an example of how to access component analysis
+    for record in batch.records() {
+        if !record.results.is_empty() {
+            println!("Component Analysis Results:\n {}",serde_json::to_string_pretty(&record.results[0].analysis.components)?);
+        }
+    }
+
+    Ok(())
+}

smarty-rust-sdk/src/us_street_api/candidate.rs

@@ -87,12 +87,14 @@ pub struct Analysis {
 }
 
 #[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
+#[serde(default)]
 pub struct MatchInfo {
     pub status: String,
     pub change: Vec<String>,
 }
 
 #[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
+#[serde(default)]
 pub struct ComponentAnalysis {
     pub primary_number: MatchInfo,
     pub street_predirection: MatchInfo,