Where Do You Go 项目技术文档

1. 安装指南

环境准备

在开始安装之前，请确保您的开发环境满足以下要求：

• Python 2.7（项目当前不支持Python 3）
• Google App Engine SDK
• Foursquare API v2 密钥
• Google Maps API 密钥

获取代码

首先，从GitHub仓库克隆项目代码：

git clone https://github.com/your-repo/where-do-you-go.git
cd where-do-you-go

配置API密钥

在项目根目录下，找到并编辑constants.py文件，添加您的Google Maps API密钥和Foursquare的消费者密钥/密钥。您还需要创建一个oauth_secrets.py文件，用于存储OAuth相关的密钥。

安装依赖

项目依赖项较少，通常不需要额外安装。如果需要，可以使用pip安装相关依赖：

pip install -r requirements.txt

2. 项目的使用说明

启动应用

在配置完成后，您可以使用Google App Engine SDK启动应用：

dev_appserver.py .

应用将在本地运行，默认地址为http://localhost:8080。

用户界面

用户可以通过浏览器访问应用，应用将显示一个基于Google Maps的热力图，展示用户在Foursquare上签到的地点。用户可以创建静态地图快照，并将其分享到Twitter。

自动更新

应用会自动在后台更新用户的地图，随着用户继续在Foursquare上签到新地点，地图会实时更新。

3. 项目API使用文档

Google Maps API

项目使用Google Maps API来渲染地图。您需要在constants.py中配置API密钥，并在代码中调用相关API来加载和显示地图。

Foursquare API

项目使用Foursquare API v2来获取用户的签到数据。您需要在constants.py中配置Foursquare的消费者密钥和密钥，并在代码中调用API来获取用户的签到信息。

4. 项目安装方式

本地开发环境

如前所述，您可以使用Google App Engine SDK在本地启动应用进行开发和测试。

部署到Google App Engine

在完成开发和测试后，您可以将应用部署到Google App Engine：

gcloud app deploy

部署完成后，应用将在Google App Engine上运行，用户可以通过分配的URL访问应用。

注意事项

由于Google App Engine和相关工具的更新，项目可能需要进行一些调整才能重新部署。具体步骤请参考项目README中的更新说明。

---

通过以上步骤，您可以成功安装、配置和使用Where Do You Go项目。如果在使用过程中遇到任何问题，请随时联系项目维护者。