Skip to main content
POST
Radius - Spatial Rank Tracking & Hyper-Local Diagnostics
Radius logo

Overview

YPYM Radius is our deterministic spatial rank diagnostics and hyper-local search visibility engine. Standard rank-tracking tools measure search performance from single, centralized synthetic proxy endpoints, completely missing the micro-variations that occur across neighborhoods, postal codes, and physical walking perimeters. Radius solves this blind spot by executing coordinate diagnostics across distributed Google S2 spherical cell matrices, calculating precise visibility radii (50m, 100m, 200m, 500m, and 1,000m), local 3-pack presence, and competitor displacement in sub-second latency.

Live Interactive Playground

Test live storefront presets, inspect interactive radar maps, and experiment in your browser at radius.ypym.app

Product Overview & Pricing

Explore enterprise methodology, multi-location case studies, and tier pricing at suite.ypym.app/radius

Authentication & Sandbox Token

Every request to the Radius REST API Gateway requires a valid Bearer token passed in the Authorization HTTP header:
For sandbox testing and immediate evaluation, use the pre-provisioned demo key: ypym_radius_demo_9876543210abcdef (or alias ypym_radius_demo_code).
Radius Spatial Rank Diagnostics API Tested on Postman

Direct Postman API execution testing the YPYM Radius endpoint (POST /api/v1/spatial/analyze) against mining enterprise entity PT KALTIM PRIMA COAL. The JSON payload returns HTTP 200 OK in 648 ms via the S2X Spatial MTPET pipeline, validating a weighted proximity score of 100 alongside dominant Google S2 spherical cell identifiers (320a35c3, 320a35ef) for deterministic local visibility benchmarking.


Request Parameters

string
default:"Bearer ypym_radius_demo_9876543210abcdef"
required
Bearer token for API gateway authentication.
string
default:"cafe di araya malang"
required
The target local search query to audit on Google Maps (e.g. cafe terdekat, resto 24 jam, coffee shop near me).
number
default:-7.9405
required
Latitude coordinate of the storefront centroid or search origin (e.g. -7.9405).
number
default:112.6565
required
Longitude coordinate of the storefront centroid or search origin (e.g. 112.6565).
string
default:"id"
Two-letter ISO 3166-1 alpha-2 country code (default: id).
string
default:"en"
ISO 639-1 language code for localized search results (default: en).
integer
default:1
Centroid matrix dimension. Use 1 for single-centroid 5-perimeter audits, or 3, 5, 7 for multi-cell spatial grid coverage (must be odd numbers).
number
default:500
Step distance between radial calculation rings in meters (default: 500).
integer
default:14
Google S2 Cell spherical projection hierarchy level (default: 14, approximately ~600m centroid diameter).
object
Configuration object for canonical brand matching and candidate identification.

Response Schema


Quickstart Implementations

Install the official client package:
Execute a 5-perimeter spatial audit:

Token Quota & Wallet Introspection

To check remaining API credits and verify token health before initiating batch auditing pipelines, query the /wallet endpoint:
Response:

Key Enterprise Use Cases


Engagement & Production Provisioning

Start Exploring on Radius Playground

Test real-world storefront presets (Malang, Bandung, Jakarta) or input your own coordinates at radius.ypym.app