GeoIdentify

GeoIdentify[enttype]

identifies the geographic entities of the type enttype in which the current geo location is contained.

GeoIdentify[enttype,loc]

identifies the entities in which the location loc is contained.

GeoIdentify[]

identifies the entities of any type in which the current geo location is contained.

Details and Options

  • GeoIdentify returns a list of Entity objects representing extended geographic regions.
  • In GeoIdentify[enttype,loc], enttype can be specified as an Entity object, such as Entity["Country"], or as a string, such as "City".
  • Valid forms for enttype include:
  • "Country"country, territory, etc.
    "City"city
    "AdministrativeDivision"administrative division of any level
    "AdministrativeDivision1"first-level administrative division
    "AdministrativeDivision2"second-level administrative division
    "AdministrativeDivision3"third-level administrative division
    "Ocean"ocean
    "USCounty"US county
    "USState"US state
    "ZIPCode"US ZIP code
    GeoVariant[enttype,variant]entities using variant regions
    EntityClass["type","class"]individual members of class
    enttype1|enttype2|any of the enttypei
    Allany possible type
  • The location loc can be specified as a GeoPosition, an Entity object, or a GeoGraphics primitive.
  • In GeoIdentify[] and GeoIdentify[regtype], the location is taken to be the current setting for $GeoLocation.

Examples

open allclose all

Basic Examples  (4)

The country of your current location:

The center of the Atlantic Ocean is not in any country:

It is basically only contained in the ocean itself:

The state and ZIP code of GeoPosition[{42.11`,-89.24`}]:

All entities containing your current geo location:

Scope  (6)

All entities containing the Willis Tower:

The city and country containing the Empire State Building:

Administrative divisions containing your current location:

The county at the center of the United States:

Hawaii is in the United States:

But it is not in this main landmass:

Determine inside which, if any, NAFTA country your current location is contained:

This location is not inside any of those countries:

Options  (1)

"FullyContained"  (1)

By default, an entity is considered to contain the location if it covers a portion of the location:

The option "FullyContained"->True excludes entities that cover only a portion of the location:

Applications  (1)

Find the countries along a great-circle path from London to New Delhi:

Visualize the path with tooltips for the countries flown over:

Properties & Relations  (3)

GeoIdentify always returns a list:

This list may be empty:

If the location queried is an extended region, there may be multiple containing entities:

For extended locations loc, GeoIdentify[enttype,loc] is essentially equivalent to GeoEntities[loc,enttype]:

Introduced in 2014
 (10.0)