LoginGeo
Represents the geographic location of the user’s IP address for a login event. Due to the nature of geolocation technology, the accuracy of geolocation fields (for example, country, city, postal code) may vary.
Introduced in API version 34.0.
describeSObjects(), query(), retrieve()
- Only users with Manage Users permissions can access this object.
- Type: string
- Properties: Filter, Group, Nillable, Sort
- Description: The city where the user’s IP address is physically located. This value is not localized.
- Type: string
- Properties: Filter, Group, Nillable, Sort
- Description: The country where the user’s IP address is physically located. This value is not localized.
- Type: string
- Properties: Filter, Group, Nillable, Sort
- Description: The ISO 3166 code for the country where the user’s IP address is physically located. For more information, see Country Codes - ISO 3166
- Type: double
- Properties: Filter, Nillable, Sort
- Description: The latitude where the user’s IP address is physically located.
- Type: datetime
- Properties: Filter, Sort
- Description: Time of the login attempt, in GMT time zone.
- Type: double
- Properties: Filter, Nillable, Sort
- Description: The longitude where the user’s IP address is physically located.
- Type: string
- Properties: Filter, Group, Nillable, Sort
- Description: The postal code where the user’s IP address is physically located. This value is not localized.
- Type: string
- Properties: Filter, Group, Nillable, Sort
- Description: The name of the subdivision where the user’s IP address is physically located. In the U.S., this value is usually the state name (for example, Pennsylvania). This value is not localized.
The API allows you to do many powerful queries. A few examples are:
| Sample Query | Query String |
|---|---|
Query showing the country for a login event, where Id=LoginGeoId from AuthSession | SELECT Country FROM LoginGeo WHERE Id = '0LE###############' |
Query showing the city and postal code for a login event, where Id=LoginGeoId from LoginHistory | SELECT City, PostalCode FROM LoginGeo WHERE Id = '0SO###############' |