Bowmark AIdocs

Positive Grid

Positive Grid's own authorized-retailer network — findRetailers finds real nearby dealers (Guitar Center and independent music shops) that carry Spark…

Positive Grid's own authorized-retailer network — findRetailers finds real nearby dealers (Guitar Center and independent music shops) that carry Spark amps, with address, phone and distance, read straight off the site's own store-locator data feed rather than a generic web guess.

Domain: positivegrid.com

Also known as: Positive Grid, PositiveGrid, Spark, Spark Amp

Call it directly

bowmark.providers.positivegrid.findRetailers(arg: positivegridFindRetailersArgs): Promise<positivegridRetailerSearch>

Functions

FunctionWhat it does
findRetailersAuthorized Positive Grid retailers near a place — real dealers who carry Spark amps, nearest first, each with street address, phone, coordinates and distance.

Types

interface positivegridFindRetailersArgs {
  /** A 5-digit US ZIP. The geocoder behind this is keyless and resolves ZIPs
   * only — a city/state or street address is refused. */
  near: string;
  /** Defaults to 50, max 500. */
  radiusMiles?: number;
  /** Defaults to 10, max 100. */
  limit?: number;
}

interface positivegridRetailer {
  /** The vendor's own numeric id for this location. */
  id: string;
  name: string;
  street: string;
  city: string | null;
  region: string | null;
  country: string | null;
  phone: string | null;
  /** The retailer's own site, when the feed publishes one. */
  url: string | null;
  latitude: number;
  longitude: number;
  /** Straight-line miles from the geocoded search centre. */
  distanceMiles: number;
}

interface positivegridRetailerSearch {
  query: string;
  center: { latitude: number; longitude: number };
  radiusMiles: number;
  /** How many rows in the FULL feed fell within radiusMiles — may exceed
   * retailers.length if the radius matched more than `limit`. */
  totalWithinRadius: number;
  /** Nearest first. */
  retailers: positivegridRetailer[];
}