---
title: Device Geofencing node
description: "Compare collected device location data against configured trusted locations to determine whether the user's device is within an allowed geofence."
component: auth-node-ref
version: 8
page_id: auth-node-ref::device-geofencing
canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/device-geofencing.html
llms_txt: https://docs.pingidentity.com/auth-node-ref/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["Nodes & Trees", "Journeys", "Authentication"]
page_aliases: ["auth-node-device-geofencing.adoc"]
superseded_by: https://docs.pingidentity.com/auth-node-ref/latest/device-geofencing.html
section_ids:
  example: Example
  availability: Availability
  inputs: Inputs
  dependencies: Dependencies
  configuration: Configuration
  outputs: Outputs
  callbacks: Callbacks
  outcomes: Outcomes
  errors: Errors
---

# Device Geofencing node

The Device Geofencing node compares any collected device location metadata with the configured trusted locations.

Use this node with the [Device Profile Collector node](device-profile-collector.html) to determine if the authenticating user's device is located within range of configured, trusted locations.

## Example

The following journey checks whether the user's device is located within ten kilometers of their company's office locations. If the device's location is within this range from one of the offices, the journey proceeds and prompts the user to authenticate. If the device's location is outside this range from all of the offices, authentication fails:

![Checking whether the current device is located within range of the trusted locations before authenticating](_images/device-profile-journey-geo.png)

* The [Device Profile Collector node](device-profile-collector.html) collects metadata about the current device, including the device's location.

* The [Device Geofencing node](device-geofencing.html) compares the current device's location with the specified trusted locations. In this example, the trusted locations are the company's offices.

* The [Page node](page.html) with the [Platform Username node](platform-username.html) and [Platform Password node](platform-password.html) prompt the user for their credentials.

* The [Data Store Decision node](data-store-decision.html) validates the username and password.

* The [Increment Login Count node](increment-login-count.html) updates the login count on successful authentication.

## Availability

| Product                               | Available? |
| ------------------------------------- | ---------- |
| PingOne Advanced Identity Cloud       | Yes        |
| PingAM (self-managed)                 | Yes        |
| Ping Identity Platform (self-managed) | Yes        |

## Inputs

This node reads the collected device metadata from the shared state.

Implement a [Device Profile Collector node](device-profile-collector.html) earlier in the journey to collect metadata for the current device.

## Dependencies

The [Device Profile Collector node](device-profile-collector.html) earlier in the journey must collect the device's location.

## Configuration

| Property                       | Usage                                                                                                                                   |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Trusted Locations *(required)* | The latitude and longitude of at least one trusted location. Separate the values with a comma. For example, `37.7910855,-122.3951663`.  |
| Geofence Radius (km)           | The maximum distance, in kilometers, that a device can be from a configured trusted location.The distance is calculated point-to-point. |

## Outputs

This node doesn't change the shared state.

## Callbacks

This node doesn't send any callbacks.

## Outcomes

* `Inside`

  The collected location is within the specified range of a configured trusted location.

* `Outside`

  The collected location is outside the specified range of all the configured trusted locations.

## Errors

This node doesn't log messages of its own.