tGoogleAddressRow - 6.1

Talend Components Reference Guide

EnrichVersion
6.1
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
task
Data Governance
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

Warning

This component will be available in the Palette of Talend Studio on the condition that you have subscribed to one of the Talend Platform products.

tGoogleAddressRow properties

Component family

Data Quality/Address

 

Function

tGoogleAddressRow accesses the Google Places API via a HTTP request to obtain geographic coordinates and other geographic information according to the address information you provided.

For further information about Google Places API, see Google Places API.

Each data row needs one or several calls to the Places API. The quota will depend on the license provided by Google. Make sure not to run the component on a data set that exceeds your quota, otherwise you will get error messages and addresses will not be corrected.

For further information about the usage limits of Google Places API, see Usage Limits and Billing.

For further information about the terms of services of Google Places API, see Terms of Service.

Purpose

tGoogleAddressRow allows you to converts human-readable addresses into geographic coordinates and other geographic information

Basic settings

Pause(in 1/10 seconds)

Time break between http requests for geographic information record. By default, the value for this field is 1.

 

Schema and Edit Schema

A schema is a row description, it defines the number of fields to be processed and passed on to the next component. The schema is either Built-in or stored remotely in the Repository.

Since version 5.6, both the Built-In mode and the Repository mode are available in any of the Talend solutions.

 

 Address column

From this list, select a parameter to be used in sending request to Google Places API. Parameters in this list are predefined in the schema of input data.

 

API key

Enter your API key in this field.

You must generate the API key from the Google Developer Console at https://developers.google.com/console/help/new/.

Note

Jobs migrated from releases older than 5.6 will need a key to run. Generate a key and set it in tGoogleAddressRow basic settings before running the Job.

The component currently works with the Google Places API and not the Google Geocoding API as it was the case in releases older than 5.6. As a result, when you run the migrated Jobs in the current studio, you will have geographic information different from what you had in older studios. For example, the Location_type column outputs ROOFTOP in older releases, while it outputs street_address now. You can find the list of location types at Place Types.

  Die on error This check box is selected by default. Clear the check box to skip the row on error and complete the process for error-free rows. If needed, you can retrieve the rows on error via a Row > Reject connection.

 Advanced settings

tStatCatcher Statistics

Select this check box to collect log data at the component level.

Global Variables

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl + Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio User Guide.

Usage

This component is used as an in-between component. It requires an input component, an output component and row Main link.

Scenario: Obtaining detailed geographic information using address information

This scenario describes a three-component Job which send HTTP request to Google Places API and obtain detailed geographic information based on the address we provided.

Setting up the Job

  1. Drop the following components from the Palette onto the design workspace: tFixedFlowInput, tGoogleAddressRow and tLogRow

  2. Connect tFixedFlowInput to tGoogleAddressRow and tGoogleAddressRow to tLogRow using Main links.

Configuring the components

  1. Double-click tFixedFlowInput to display its Basic settings view to define its properties.

  2. Click Edit schema to open a dialog box that displays the data structure of input data and define the data you want to pass to tGoogleAddressRow, two columns in this scenario, AddressID and Address, and then click OK to close the dialog box.

  3. Click Use Inline Table in the Mode area of the Basic settings view of tFixedFlowInput, and click the [+] button to add one column to the table.

  4. Fill in the field in the AddressID column with 1 and the Address column with "500 Oracle Parkway,Redwood Shores, CA 94065".

  5. Double-click tGoogleAddressRow to display its Basic settings view and define its properties.

  6. Select Address from the Address Column list and let the rest of settings as they are.

  7. Double-click tLogRow to display its Basic settings view and define its properties.

  8. Select Vertical (each row is a key/value list) in the Mode area and Print unique name in the Title printing mode area.

Executing the Job

  • Save your Job and press F6 to execute it.

    Google Places API has query limits for applications that submit requests. For further information about the usage limits of Google Places API, see Usage Limits and Billing.

    The detailed geographic information of 500 Oracle Parkway,Redwood Shores, CA 94065 is obtained from the Google Map database and printed onto the console.