Generate a GDELT GEO V2 API query

Source: R/gdelt_full_text_api.R

This function will generate a V2 GEO api query and either open the URL in the browser for exploration or download the GEOJSON data for users to explore in R

ft_geo_query(
  query_parameters = list(term = NULL, domain = NULL, gkg_theme = NULL, image_face_tone
    = NULL, image_num_faces = NULL, image_ocr = NULL, image_tag = NULL, image_web_tag =
    NULL, image_web_count = NULL, location_name = NULL, location_adm1 = NULL,
    location_country = NULL, near = NULL, source_country = NULL, source_language = NULL,
    tone = NULL, tone_absolute_value = NULL),
  mode = "adm1",
  format = "ImageHTML",
  timespan = NULL,
  max_points = NULL,
  geore = NULL,
  sort = NULL,
  browse_url = TRUE
)

Arguments

query_parameters

list of query parameters

  • term: search team

  • domain: web domain

  • image_face_tone: image face tone

  • image_num_face: number of faces

  • image_ocr: OCR to find

  • image_tag: image tagcode

  • image_web_tag: image web code

  • image_web_count: image count

  • location_name: name of the location

  • location_adm1: adm code

  • location_country: country

  • near: specified distances

  • source_country: source country

  • source_language: source language

  • gkg_theme: GKG theme

  • tone: numeric tone

  • tone_absolute_value:

mode

visualization mode

  • PointData

  • ImagePointData

  • PointHeatmap

  • ImagePointheatmap

  • PointAnimation

  • ImagePointAnimation

  • Country

  • ImageCountry

  • SourceCountry

  • ImageSourceCountry

  • ADM1

  • ImageADM1

format

format of the output

  • html: HTML

  • ImageHTML: image html

  • GeoJSON: geoJSON

  • ImageGeoJSON: geoJSON with images

  • Imagehtmlshow: shows overlay-ed pictures on map

timespan

time span 15 to 1440 minutes

max_points

maximum number of points

geore

geore level

  • 0: All locations

  • 1: Excludes country mentions

  • 2: Only landmarks

sort

how to sort the data

  • date: by date

  • toneDesc: Tone descending

  • toneAsc: Tone ascending

browse_url

if TRUE open url in browser

Value

References

GDELT GEO API

Examples

ft_geo_query(query_parameters = list(term = "Brooklyn Nets"))