skills.rest
amoai-tech
amoai-techCOMMUNITY
Explore all skills by this author →
GitHub

mde-maps

Implements Google Maps Platform APIs, Places enrichment, and Gemini Maps grounding for the mdeAI application.

1|Updated Sep 15, 2026
Search Tags:#mcp#geocoding#google-maps#places-api#gemini-grounding#maps-javascript-api#medellin
One-click install
npx skills add https://github.com/amoai-tech/mdeai --skill mde-maps-amoai-tech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mde-maps
Source: https://github.com/amoai-tech/mdeai/tree/main/.claude/skills/mde-maps
Command: npx skills add https://github.com/amoai-tech/mdeai --skill mde-maps-amoai-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Developers working on the mdeAI Medellín concierge app need correct, current guidance for integrating Google Maps Platform APIs—Places API (New), Maps JavaScript API, Gemini Maps grounding, and 20+ batch APIs—without hitting deprecated endpoints, billing surprises, or Terms of Service violations. ## Core Features & Use Cases - Places API (New) enrichment: Field-mask patterns, Node.js client examples, and Medellín-anchored location bias for seeding venue data (place_id, maps_url, lat/lng) into Supabase. - Gemini Maps grounding: Sequential call patterns, intent gating with English/Spanish GEO_PATTERNS, quota guards, and ToS-compliant attribution for live geo chat queries. - Universal CLI (gmaps.py): A stdlib-only Python client covering geocoding, routes, places, weather, air quality, solar, and more for batch operations. - Use Case: When implementing a "restaurants near me open now" chat feature, follow the skill's intent-gate and sequential grounding call pattern to return cited, structured results without exceeding the 500/day free tier. ## Quick Start Ask the assistant to show how to enrich a Medellín venue with Places API (New) field masks using the mde-maps skill.

Frequently Asked Questions about mde-maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use Places API (New) field masks for venue enrichment?▼

Send searchText requests with the X-Goog-FieldMask header listing only needed fields such as places.id, places.googleMapsLinks, and places.location. Billing is field-mask driven, so requesting fewer fields reduces cost per call.

How does Gemini Maps grounding work with structured JSON output?▼

Maps grounding combined with responseMimeType application/json in one call is not confirmed by Google, so use two sequential calls: a grounded call first, then a structured output call with grounding context injected as text.

Can I use the Google Places API key in frontend VITE_ environment variables?▼

No. Server-side keys like GOOGLE_PLACES_API_KEY must never be placed in VITE_ variables because they become visible in browser DevTools. Only the Maps JavaScript API key belongs in frontend variables, restricted by HTTP referrers.

Why does generativeSummary return null for Medellín venues?▼

The generativeSummary field is English-only and currently covers only the US and India, so it always returns null for Colombian venues. Generate ai_summary with Gemini generateContent directly at seed time instead.

When should I not use this Google Maps skill?▼

Avoid it for Mapbox-only or Leaflet/OpenStreetMap stacks, pure GIS spatial math with no Google Maps Platform APIs, and generic mapping tutorials unrelated to the mdeAI repository.

Related Skills

Explore More Software Engineering Skills→
awslabsawslabs
856

amazon-location-service

Integrate Amazon Location Service APIs for maps, geocoding, routing, and tracking.

Official
Advanced
shobhit-16shobhit-16

interactive-widgets

Stream interactive Flutter widgets within AI conversation streams via Nexus.

Community
Advanced
grafanagrafana
213

cost-management

Manage Grafana Cloud costs with label-based attribution and usage alerts.

Official
Intermediate
openaiopenai
5.3k

geospatial-and-cartographic-visualization

Design thematic maps, slippy maps, and geospatial visualizations with D3 geo, Leaflet, MapLibre, and deck.gl.

Official
Advanced