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.1
6 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
If left empty, most providers will attempt to retrieve data for client IP address.

Example

Result (object)

ipAddress
IP address from the input or client IP address.
addressCountryCode
ISO 3166-1 alpha-2 country code.
addressCountry
The country. For example, USA.
addressRegion
The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division.
addressLocality
The locality in which the street address is, and which is in the region. For example, Mountain View.
postalCode
The postal code. For example, 94043.
timeZone
The IANA time zone of the location. For example, America/Los_Angeles.
latitude
The latitude of a location. For example 37.42242 (WGS 84).
longitude
The longitude of a location. For example -122.08585 (WGS 84).

Example

Implementation details

Provider
mock
Use case
IpGeolocation
Author
@superface
Source
Verified