Communitygithub.com

YepAPI/skills

Integração com Mapbox/Leaflet, geocodificação, localizadores de lojas, agrupamento de marcadores e exibição de rotas.

O que é skills?

Este skill fornece todas as diretrizes e padrões necessários para integrar mapas e geolocalização em aplicações web modernas, especialmente com React e Next.js. Ele cobre duas bibliotecas principais de mapas: Mapbox GL JS (via `react-map-gl`) para mapas interativos ricos, e Leaflet (via `react-leaflet`) como alternativa gratuita sem necessidade de chave de API para tiles básicos. O skill inclui padrões para gerenciamento de chaves de API (usando `NEXT_PUBLIC_MAPBOX_TOKEN` no lado do cliente), geocodificação (endereço para coordenadas) usando Mapbox Geocoding API ou OpenStreetMap Nominatim, agrupamento de marcadores com `supercluster` para grandes conjuntos de dados, e o padrão de localizador de lojas que combina geolocalização do usuário, cálculo de distância Haversine e exibição no mapa. Também aborda exibição de rotas com Mapbox Directions API, tratamento de permissão de geolocalização do navegador e carregamento lazyload de componentes de mapa para evitar problemas de renderização no servidor. É ideal para desenvolvedores construindo aplicações com funcionalidades de mapa e localização, como localizadores de lojas, dashboards geoespaciais e ferramentas de logística.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/maps-geolocation

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Mapas e Geolocalização

Regras

  • Mapbox GL JS para mapas interativos ricos — react-map-gl como wrapper para React
  • Leaflet como alternativa gratuita — react-leaflet para React, sem necessidade de chave de API para tiles básicos
  • Gerenciamento de chaves de API: NEXT_PUBLIC_MAPBOX_TOKEN para Mapbox no lado do cliente, nunca exponha segredos do lado do servidor
  • Geocodificação: converter endereços em coordenadas — API de Geocodificação do Mapbox ou OpenStreetMap Nominatim (gratuito)
  • Agrupamento de marcadores: use supercluster ou o agrupamento embutido do Mapbox para grandes conjuntos de dados (100+ marcadores)
  • Padrão de localizador de lojas: geocodificar localização do usuário → consultar lojas próximas com Haversine/PostGIS → exibir no mapa
  • Exibição de rotas: API de Direções do Mapbox para rotas de carro/a pé, renderizar como camada GeoJSON LineString
  • Geolocalização do navegador: navigator.geolocation.getCurrentPosition() — sempre trate a permissão negada com elegância
  • Carregar componente de mapa com lazyload — mapas são pesados; use dynamic(() => import("./Map"), { ssr: false })

Padrões

// react-map-gl com Mapbox
import Map, { Marker, NavigationControl } from "react-map-gl";
import "mapbox-gl/dist/mapbox-gl.css";

function StoreMap({ stores }: { stores: Store[] }) {
  return (
    <Map
      initialViewState={{ longitude: -122.4, latitude: 37.8, zoom: 11 }}
      mapboxAccessToken={process.env.NEXT_PUBLIC_MAPBOX_TOKEN}
      mapStyle="mapbox://styles/mapbox/streets-v12"
      style={{ width: "100%", height: 400 }}
    >
      <NavigationControl position="top-right" />
      {stores.map((store) => (
        <Marker key={store.id} longitude={store.lng} latitude={store.lat}>
          <Pin />
        </Marker>
      ))}
    </Map>
  );
}
// Distância Haversine para busca de proximidade
function haversineDistance(lat1: number, lon1: number, lat2: number, lon2: number): number {
  const R = 6371; // km
  const dLat = ((lat2 - lat1) * Math.PI) / 180;
  const dLon = ((lon2 - lon1) * Math.PI) / 180;
  const a = Math.sin(dLat / 2) ** 2 + Math.cos((lat1 * Math.PI) / 180) * Math.cos((lat2 * Math.PI) / 180) * Math.sin(dLon / 2) ** 2;
  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
}

Evitar

  • Renderizar componentes de mapa no lado do servidor — sempre carregue com ssr: false ou "use client"
  • Renderizar 1000+ marcadores sem agrupamento — prejudica o desempenho; use supercluster
  • Codificar coordenadas fixas — geocode endereços em tempo de build ou sob demanda
  • Ignorar a negação de permissão de geolocalização — sempre forneça uma alternativa (entrada manual de endereço)

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Habilidades Relacionadas