ee.FeatureCollection.loadBigQueryTable

  • The loadBigQueryTable function reads data from a BigQuery table and returns a FeatureCollection.

  • The function requires the path to the BigQuery table and optionally accepts a parameter for the geometry column.

  • Examples demonstrate how to use loadBigQueryTable in both JavaScript and Python to load and display geographical features from a BigQuery table.

 Reads data from a BigQuery table and presents the results as a FeatureCollection.

UsageReturns
ee.FeatureCollection.loadBigQueryTable(table, geometryColumn)FeatureCollection
ArgumentTypeDetails
tableStringPath to BigQuery table in a `project.dataset.table` format.
geometryColumnString, default: nullThe name of the column to use as the main feature geometry. If not specified, the first column with GEOGRAPHY type will be used.

Examples

Code Editor (JavaScript)

// Load stations from the New York Subway System.
var features = ee.FeatureCollection.loadBigQueryTable({
  table: 'bigquery-public-data.new_york_subway.stations',
  geometryColumn: 'station_geom',
});

// Display all relevant features on the map.
Map.setCenter(-73.90, 40.73, 11);
Map.addLayer(features,
             {'color': 'black'},
             'Stations from New York Subway System');

// Print all stations in the "Astoria" line.
var line = features.filter(ee.Filter.eq('line', 'Astoria'));
print(line);
Map.addLayer(line,
             {'color': 'yellow'},
             'Astoria line');

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# Load stations from the New York Subway System.
features = ee.FeatureCollection.loadBigQueryTable(
    table="bigquery-public-data.new_york_subway.stations",
    geometryColumn="station_geom")

# Display all relevant features on the map.
m = geemap.Map()
m.set_center(-73.90, 40.73, 11)
m.add_layer(
    features, {'color': 'black'}, 'Stations from New York Subway System')

# Print all stations in the "Astoria" line.
line = features.filter(ee.Filter.eq('line', 'Astoria'))
display(line)
m.add_layer(line, {'color': 'yellow'}, 'Astoria line')
m