August 17, 2023

tGoogleMapLookup – Docs for ESB 5.x




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.

tGoogleMapLookup properties

Component family

Data Quality/Address



tGoogleMapLookup accesses the
Google Places API over HTTP request to obtain detailed geographic
information according to the geographic coordinates you

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

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


tGoogleMapLoopup allows you to
obtain detailed geographic information using geographic coordinates
and address information.

Basic settings

Schema and Edit

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.


Sync columns

Click this button to retrieve schema from the previous component
connected in the Job.

  Pause(in 1/10 seconds) Time break between http requests for geographic
information record. By default, the value for this field is 1.
  Latitude Column Select the schema column that holds the latitude
  Longitude Column Select the schema column that holds the longitude


API key

Enter your API key.

You must generate the API key from the Google Developer Console at


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

The geographic information you get from these Jobs could be
different from the information you previously get when they
query the Google Maps API.

 Advanced settings


Customize this field to import Java class for tGoogleMapLookup. By default, you do not
have to modify this part.

  tStatCatcher Statistics

Select this check box to collect log data at the component

  Enable parallel execution

Select this check box to perform high-speed data processing, by treating multiple data flows
simultaneously. Note that this feature depends on the database or the application ability to
handle multiple inserts in parallel as well as the number of CPU affected. In the Number of parallel executions field, either:

  • Enter the number of parallel executions desired.

  • Press Ctrl + Space and select the appropriate
    context variable from the list. For further information, see Talend Studio
    User Guide

Note that when parallel execution is enabled, it is not possible to use global variables to
retrieve return values in a subjob.


  • The Action on table
    field is not available with the parallelization function. Therefore, you
    must use a tCreateTable component if you
    want to create a table.

  • When parallel execution is enabled, it is not possible to use global
    variables to retrieve return values in a subjob.

Global Variables

NB_LINE: the number of rows read by an input component or
transferred to an output component. This is an After variable and it returns an

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 +
to access the variable list and choose the variable to use from it.

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


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 and geographic

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


Setting up the Job

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

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

Configuring the components

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

  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 tGoogleMapLookup, two columns in
    this scenario, lat and lng
    respectively to hold the geographic coordinates.

  3. Set the Type of column
    lat and column lng to
    Double. Leave rest of the settings as
    they are. Then, click OK to close the
    dialog box.

  4. Click Use Single Table in the Mode area, fill the Value field of the lat column with
    37.5300125 and that of the lng column
    with -122.2624254.

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

  6. Select the latitude and longitude columns defined in the input schema,
    lat and lng respectively in this example, and leave the rest of
    settings as they are.

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

  8. Select Vertical (each row is a key/value
    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

    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


The detailed geographic information of the given coordinates location is obtained
from the Google Map database and printed onto the console.

Document get from Talend
Thank you for watching.
Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x