Geocoding, clustering, deep-linking, print, etc. — a suite of APIs for your advanced needs.

# Forward geocoding: address → coordinates
curl "https://api.getwemap.com/v3.0/geocoding/geocode?address=10+rue+de+Rivoli%2C+Paris" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Reverse geocoding: coordinates → address
curl "https://api.getwemap.com/v3.0/geocoding/geocode?latitude=48.8566&longitude=2.3522" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Optional: use an alternate geocoding provider
# &extra_provider=true

// Generate a deep link to a specific POI
const deepLink = WemapDeepLink.toPoi({
  mapId: 'YOUR_MAP_ID',
  poiId: 1234,
  // Optional: center map on this POI and open its panel
  action: 'open',
});

// Universal link (works in browser + native apps)
// → https://app.getwemap.com/m/YOUR_MAP_ID?poi=1234&action=open

// Native deep link (iOS Universal Links / Android App Links)
// → wemap://maps/YOUR_MAP_ID/poi/1234

// Share from native app
Share.share({ url: deepLink.universal });

import { WemapSearch, WemapGeocoding } from '@wemap/sdk';

const search = new WemapSearch({ mapId: 'YOUR_MAP_ID' });
const geo = new WemapGeocoding({ apiKey: 'YOUR_API_KEY' });

// Full-text search with proximity boost
const results = await search.query('restaurant', {
  near: { lat: 48.87, lng: 2.31 },
  radius: 500,
  filters: { category: 'food' },
});
console.log(`Found ${results.total} results`);

// Geocode an address
const location = await geo.forward('10 rue de Rivoli, Paris');
console.log(location.coordinates); // { lat: 48.8601, lng: 2.3479 }

// Reverse geocode
const address = await geo.reverse({ lat: 48.8566, lng: 2.3522 });
console.log(address.formatted); // "Place du Louvre, Paris"