GeoNames To Geodatabase (Topographic Production)

Summary

Loads GeoNames data into a feature class and table. The feature class is composed of point features, and the table contains fields with information concerning the naming conventions used for the features. The feature class contains the Unique Feature Identifier (UFI) and Unique Name Identifier (UNI), which match the same fields in the GeoNames table.

Usage

  • Before loading the GeoNames data into your database, the feature class and table must already exist.

  • If your organization already has a GeoNames database, this database may be used as long as it contains the UFI and UNI fields.

Parameters

LabelExplanationData Type
GeoNames Source File

Path to the source file containing GeoNames information. This needs to be a properly formatted GeoNames file.

Shapefile; Text File
GeoNames Feature Class Name

The GeoNames feature class; this feature class should be in the working database.

Feature Class
Allow Duplicates

Allows duplicate features in the GeoNames feature class.

  • Checked—Allows the tool to import features even if there is already an entry in the GeoNames feature class and table.
  • Unchecked—Prevents the tool from importing features if there is another feature with the same geometry and attributes in the GeoNames feature class or GeoNames table. This is the default.
Boolean
GeoNames Table Name

The GeoNames table. This table should be in the working database.

Table

Derived Output

LabelExplanationData Type
Out feature class

Output feature class containing GeoName features.

Feature Class
Out table

Output table containing attribution for GeoName features.

Table

arcpy.topographic.GeoNamesToGeodatabase(in_source, in_feature_class, in_allow_duplicates, in_table)
NameExplanationData Type
in_source

Path to the source file containing GeoNames information. This needs to be a properly formatted GeoNames file.

Shapefile; Text File
in_feature_class

The GeoNames feature class; this feature class should be in the working database.

Feature Class
in_allow_duplicates

Allows duplicate features in the GeoNames feature class.

  • ALLOW_DUPLICATESAllows the tool to import features even if there is already an entry in the GeoNames feature class and table.
  • DON'T_ALLOW_DUPLICATESPrevents the tool from importing features if there is another feature with the same geometry and attributes in the GeoNames feature class or GeoNames table. This is the default.
Boolean
in_table

The GeoNames table. This table should be in the working database.

Table

Derived Output

NameExplanationData Type
out_featureclass

Output feature class containing GeoName features.

Feature Class
out_table

Output table containing attribution for GeoName features.

Table

Code sample

GeoNamesToGeodatabase example (stand-alone script)

The following stand-alone script demonstrates how to use the GeoNamesToGeodatabase function to import GeoNames from a properly formatted text file to a selected GeoNames feature class and table.

# Name: GeoNamesToGeodatabase_sample.py
# Description: Use the GeoNames To Geodatabase tool to import GeoNames from a properly formatted text file to a selected GeoNames feature class and table

# Import System Modules
import arcpy

# Check Out Extensions
arcpy.CheckOutExtension('Foundation')

# Setting Local Variables
source_file = r'C:\Temp\al_populatedplaces_p.txt'
feature_class = r'C:\Temp\Geonames_Template.gdb\GeoNames_FeaturesP'
in_table = r'C:\Temp\Geonames_Template.gdb\GEONAMES_TABLE'

# Use the GeoNames To Geodatabase tool to import GeoNames from a properly formatted text file
arcpy.topographic.GeoNamesToGeodatabase(source_file, feature_class, 'DONT_ALLOW_DUPLICATES', in_table)

# Check In Extensions
arcpy.CheckInExtension('Foundation')

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires Production Mapping
  • Advanced: Requires Production Mapping

Related topics