Back to Details

google-maps

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Maps Skill

Google Maps 技能

Overview

概述

Claude can use Google Maps to search for locations, get directions, find businesses, check traffic, and explore places. Useful for trip planning, finding nearby services, and navigation assistance.
Claude可借助Google Maps搜索地址、获取路线、查找商家、查看交通状况并探索场所。适用于行程规划、查找周边服务以及导航辅助。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/google-maps/install.sh | bash
Or manually:
bash
cp -r skills/google-maps ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/google-maps/install.sh | bash
或手动安装：
bash
cp -r skills/google-maps ~/.canifi/skills/

Setup

配置设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置：
bash
undefined

First, ensure canifi-env is installed:

首先，确保canifi-env已安装：

curl -sSL https://canifi.com/install.sh | bash

curl -sSL https://canifi.com/install.sh | bash

canifi-env set GOOGLE_EMAIL "your-email@gmail.com"
undefined
canifi-env set GOOGLE_EMAIL "your-email@gmail.com"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
您的凭据，由您掌控。 Canifi LifeOS尊重您的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果您不想与Claude Code共享凭据：
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用您的已认证会话，且全程不会看到您的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果您愿意共享凭据，可将其存储在本地：
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意：存储在canifi-env中的凭据仅可在您的本地设备上访问，绝不会被传输至外部。

Capabilities

功能特性

  • Search for addresses and places
  • Get driving, walking, transit, and cycling directions
  • Find nearby restaurants, gas stations, and services
  • Check real-time traffic conditions
  • View business hours and reviews
  • Save places to lists
  • Measure distances
  • Explore street view
  • Share locations
  • Get estimated travel times
  • View satellite imagery
  • Find parking information
  • 搜索地址和场所
  • 获取驾车、步行、公共交通及骑行路线
  • 查找周边餐厅、加油站及服务场所
  • 查看实时交通状况
  • 查看商家营业时间和评价
  • 将场所保存至列表
  • 测量距离
  • 探索街景视图
  • 分享地点
  • 获取预估出行时间
  • 查看卫星图像
  • 查找停车信息

Usage Examples

使用示例

Example 1: Get Directions

示例1：获取路线

User: "How do I get from my house to the airport?"
Claude: Searches route, gets directions.
        Reports: "25.3 miles via I-95, approximately 32 minutes with current traffic.
        Fastest route: Take Main St to I-95 North..."
用户："我从家到机场怎么走？"
Claude：搜索路线并获取导航信息。
        回复："全程25.3英里，走I-95高速，当前路况下约需32分钟。
        最快路线：从主街驶入I-95北方向..."

Example 2: Find Nearby Places

示例2：查找周边场所

User: "Find coffee shops near downtown"
Claude: Searches for coffee shops in downtown area.
        Reports: "Found 12 coffee shops:
        1. Blue Bottle Coffee (0.2 mi) - 4.5 stars, open until 6pm
        2. Starbucks (0.3 mi) - 4.0 stars, open 24 hours..."
用户："找市中心附近的咖啡店"
Claude：搜索市中心区域的咖啡店。
        回复："找到12家咖啡店：
        1. Blue Bottle Coffee（0.2英里）- 4.5星，营业至18:00
        2. Starbucks（0.3英里）- 4.0星，24小时营业..."

Example 3: Check Business Info

示例3：查询商家信息

User: "What are the hours for Whole Foods on Main Street?"
Claude: Finds specific Whole Foods location, reads hours.
        Reports: "Open today 8am-10pm. Phone: (555) 123-4567"
用户："主街上的Whole Foods营业时间是什么？"
Claude：找到指定的Whole Foods门店，读取营业时间。
        回复："今日营业时间为8:00-22:00。电话：(555) 123-4567"

Example 4: Compare Routes

示例4：对比路线

User: "What's the fastest way to work right now?"
Claude: Checks traffic on multiple routes.
        Reports: "Route 1 via highway: 28 min (normal traffic)
        Route 2 via surface streets: 35 min (some congestion)
        Recommend Route 1"
用户："现在去公司最快的路线是什么？"
Claude：查看多条路线的交通状况。
        回复："路线1：走高速，28分钟（正常路况）
        路线2：走地面道路，35分钟（部分路段拥堵）
        推荐路线1"

Authentication Flow

认证流程

  1. Claude navigates to maps.google.com via Playwright MCP
  2. Authenticates with GOOGLE_EMAIL if needed (for saved places)
  3. Handles 2FA if prompted (notifies user via iMessage)
  4. Maintains session for personalized features
  1. Claude通过Playwright MCP导航至maps.google.com
  2. 若需要（如访问已保存场所），使用GOOGLE_EMAIL进行认证
  3. 若提示双重认证，将通过iMessage通知用户
  4. 维持会话以提供个性化功能

Selectors Reference

选择器参考

javascript
// Search box
'#searchboxinput'

// Search button
'#searchbox-searchbutton'

// Directions button
'[aria-label="Directions"]'

// From/To inputs
'input[aria-label="Choose starting point"]'
'input[aria-label="Choose destination"]'

// Travel mode buttons
'[aria-label="Driving"]'
'[aria-label="Transit"]'
'[aria-label="Walking"]'
'[aria-label="Cycling"]'

// Route options
'.section-directions-trip'

// Place details panel
'.section-hero-header-title'

// Hours
'[aria-label*="Hours"]'

// Reviews
'.section-star-display'

// Save button
'[aria-label="Save"]'

// Share button
'[aria-label="Share"]'

// Traffic layer
'[aria-label="Traffic"]'
javascript
// 搜索框
'#searchboxinput'

// 搜索按钮
'#searchbox-searchbutton'

// 路线按钮
'[aria-label="Directions"]'

// 起点/终点输入框
'input[aria-label="Choose starting point"]'
'input[aria-label="Choose destination"]'

// 出行方式按钮
'[aria-label="Driving"]'
'[aria-label="Transit"]'
'[aria-label="Walking"]'
'[aria-label="Cycling"]'

// 路线选项
'.section-directions-trip'

// 场所详情面板
'.section-hero-header-title'

// 营业时间
'[aria-label*="Hours"]'

// 评价
'.section-star-display'

// 保存按钮
'[aria-label="Save"]'

// 分享按钮
'[aria-label="Share"]'

// 交通图层
'[aria-label="Traffic"]'

Error Handling

错误处理

  • Login Failed: Retry 3 times, notify user via iMessage
  • Session Expired: Re-authenticate automatically
  • Location Not Found: Suggest alternatives, ask for clarification
  • Directions Failed: Check start/end points, try different modes
  • No Results: Broaden search area, try different keywords
  • Traffic Data Unavailable: Report estimated time without traffic
  • 登录失败：重试3次，通过iMessage通知用户
  • 会话过期：自动重新认证
  • 地点未找到：提供替代建议，请求用户澄清
  • 路线获取失败：检查起点/终点，尝试不同出行方式
  • 无搜索结果：扩大搜索范围，尝试不同关键词
  • 交通数据不可用：报告无交通状况的预估时间

Self-Improvement Instructions

自我优化说明

When you learn a better way to accomplish a task with Google Maps:
  1. Document the improvement in your response
  2. Suggest updating this skill file with the new approach
  3. Include specific search strategies for better results
  4. Note any new features or navigation improvements
当您掌握了使用Google Maps完成任务的更优方法时：
  1. 在回复中记录该优化点
  2. 建议使用新方法更新此技能文件
  3. 包含可获得更优结果的具体搜索策略
  4. 记录任何新功能或导航改进

Notes

注意事项

  • Real-time traffic updates every few minutes
  • Transit schedules may vary; confirm with transit authority
  • Street View coverage varies by location
  • Saved places sync across devices
  • Offline maps can be downloaded for areas
  • Business info from Google Business Profile
  • Reviews aggregated from Google users
  • Estimated times vary based on traffic conditions
  • Wheelchair accessible routes available
  • Toll roads can be avoided in directions settings
  • 实时交通状况每几分钟更新一次
  • 公共交通时刻表可能变动，请以交通部门信息为准
  • 街景视图覆盖范围因地区而异
  • 已保存场所在设备间同步
  • 可下载离线地图供特定区域使用
  • 商家信息来自Google商家档案
  • 评价整合自Google用户
  • 预估时间因交通状况而异
  • 提供无障碍路线选项
  • 可在路线设置中避开收费道路