You are viewing a section of Superface that will be deprecated in Q4 2023. Until then, you can continue to use it as you have before but we recommend that you migrate to our latest version soon. For more details visit superface.ai/docs/migrate.
IP geolocation lookup
address/ip-geolocation@1.0.16 providers
IP Geolocation
Retrieve address and geolocation coordinates from IP address
Input
IP address
Result
IP address
Country code
Country
Region
Locality
Postal code
Time zone
Latitude
Longitude
1.Choose a provider
2.Use IpGeolocation with mock in your code
Below instructions are for our Node.js SDK. Use OneService for other languages.
npm i @superfaceai/one-sdk
Structure details
Input (object)
ipAddress
optional
If left empty, most providers will attempt to retrieve data for client IP address.
string
Example
Result (object)
ipAddress
optional
IP address from the input or client IP address.
string
addressCountryCode
optional
ISO 3166-1 alpha-2 country code.
string
addressCountry
optional
The country. For example, USA.
string
addressRegion
optional
The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division.
string
addressLocality
optional
The locality in which the street address is, and which is in the region. For example, Mountain View.
string
postalCode
optional
The postal code. For example, 94043.
string
timeZone
optional
The IANA time zone of the location. For example, America/Los_Angeles.
string
latitude
optional
The latitude of a location. For example 37.42242 (WGS 84).
number
longitude
optional
The longitude of a location. For example -122.08585 (WGS 84).
number