Geolocation

Get user’s geolocation data

Overview

The getGeolocationData() utility function retrieves the user’s current geolocation coordinates.

Import

import { getGeolocationData } from "magenx404/utils";

Usage

import { getGeolocationData } from "magenx404/utils";

const location = await getGeolocationData();
console.log(location);
// {
//   latitude: 37.7749,
//   longitude: -122.4194,
//   error: null,
//   isFetching: false
// }

Return Value

latitude · number | null

User’s latitude coordinate

longitude · number | null

User’s longitude coordinate

error · string | null

Error message if geolocation access failed or was denied

isFetching · boolean

Whether geolocation is currently being fetched

Example

"use client";

import { getGeolocationData } from "magenx404/utils";
import { X404Blacklist } from "magenx404";

export async function authenticateWithLocation() {
  // Get user's location
  const location = await getGeolocationData();

  if (location.error) {
    console.error("Geolocation error:", location.error);
    // Continue without location or handle error
  }

  // Use location in authentication
  const result = await X404Blacklist({
    excluded_mints: ["token_address"],
    max_holdings: {},
    geo_code: location.latitude ? "true" : "false",
    geo_code_locs: "",
    coords: {
      latitude: location.latitude,
      longitude: location.longitude,
    },
  });

  return result;
}

Error Handling

The function handles various geolocation scenarios:

• Permission denied: User denied location access
• Timeout: Location request timed out
• Not available: Geolocation API not available
• Position unavailable: Could not determine position

const location = await getGeolocationData();

if (location.error) {
  switch (location.error) {
    case "User denied Geolocation":
      console.log("User denied location access");
      break;
    case "Position unavailable":
      console.log("Could not determine position");
      break;
    default:
      console.log("Geolocation error:", location.error);
  }
}

The browser will prompt the user for location permission on first use. Make sure to handle cases where the user denies permission.