Location

Location data in Legacy Search datasets contain information related to the geographic location of the host. A complete list of host data fields and information is available in the in-app data definitions page.

Example fields

Field	Type	Description
`location`	object
`location.city`	text	The English name of the detected city.
`location.continent`	keyword	The English name of the detected continent (North America, Europe, Asia, South America, Africa, Oceania, Antarctica).
`location.coordinates`	object	The estimated coordinates of the detected location.
`location.coordinates.latitude`	double
`location.coordinates.longitude`	double
`location.country`	text	The English name of the detected country.
`location.country_code`	keyword	The detected two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...).
`location.postal_code`	keyword	The postal code (if applicable) of the detected location.
`location.province`	text	The state or province name of the detected location.
`location.registered_country`	text	The English name of the registered country.
`location.registered_country_code`	keyword	The registered country's two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...).
`location.timezone`	text	The IANA time zone database name of the detected location.

Example queries

Query description	Legacy Search query	Run query in Legacy Search
Find hosts by city	`location.city: Moscow`	Try it
Search for hosts whose location is within a box specified by its geographic coordinates Draw a box and open Search with the coordinate ranges populated	`location.coordinates.latitude: [31.2221970321032 to 31.596082850911525] and location.coordinates.longitude: [34.16473388671876 to 34.58908081054688]`	Try it
Return all hosts located either in the United States or Canada	`location.country: Canada or location.country: “United States”`	Try it
Return all hosts whose country is among this set of countries in the Americas	`location.country: {Canada, Chile, Honduras, Mexico, “United States”, Uruguay}`	Try it
Search for hosts in the U.S. with any reference to the string "teslamate"	`(teslamate) and location.country="United States"`	Try it
Search for hosts in Russia	`location.country: Russia`	Try it
Find hosts running software from a specific country	`location.country: Russia and services.software.product: gSOAP`	Try it
Search for hosts in Israel, excluding Tel Aviv	`location.country_code=IL and not location.city: "Tel Aviv"`	Try it
Find hosts by country	`location.country: Russia`	Try it
Find North Korean Hosts	`location.country: "North Korea"`	Try it
Find hosts by state	`location.province: Michigan`	Try it
Find hosts by state and city	`location.province: Michigan and location.city: Detroit`	Try it

Updated 7 months ago