tAddLocationFromIP Properties - 6.1

Talend Components Reference Guide

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
Data Governance
Data Quality and Preparation
Design and Development
Talend Studio

Component family




tAddLocationFromIP replaces IP addresses with geographical locations.


tAddLocationFromIP helps you to geolocate visitors through their IP addresses. It identifies visitors' geographical locations country, region, city, latitude, longitude, ZIP code...etc.using an IP address lookup database file.

Basic settings

Schema and Edit schema

A schema is a row description, it defines the fields to be processed and passed on to the next component. The schema of this component is read-only.



Built-in: You create and store the schema locally for this component only. Related topic: see Talend Studio User Guide.



Repository: Select the Repository file where Properties are stored. When selected, the fields that follow are pre-defined using fetched data.


Database Filepath

The path to the IP address lookup database file.


Input parameters

Input column: Select the input column from which the input values are to be taken.



input value is a hostname: Check if the input column holds hostnames.



input value is an IP address: Check if the input column holds IP addresses.


Location type

Country code: Check to replace IP with country code.



Country name: Check to replace IP with country name.

Global Variables

NB_LINE: the number of rows processed. This is an After variable and it returns an integer.

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.


This component is an intermediary step in the data flow allowing to replace IP with geolocation information. It can not be a start component as it requires an input flow. It also requires an output component.


Due to license incompatibility, the following JAR required to use this component is not provided. You can easily add the JAR by following the How to install external modules section of Talend Studio User Guide.

  • geoip.jar