WifiLocation 项目使用教程

WifiLocation 项目使用教程

WifiLocationGoogle GeoLocation API wrapper for Arduino MKR1000, ESP8266 and ESP32项目地址:https://gitcode.com/gh_mirrors/wi/WifiLocation

1. 项目的目录结构及介绍

WifiLocation/
├── examples/
│   ├── BasicUsage/
│   └── WifiLocationServer/
├── src/
│   ├── WifiLocation.cpp
│   └── WifiLocation.h
├── keywords.txt
├── library.properties
└── README.md

• examples/: 包含项目的示例代码，如 BasicUsage 和 WifiLocationServer。
• src/: 包含项目的主要源代码文件，如 WifiLocation.cpp 和 WifiLocation.h。
• keywords.txt: 关键字文件，用于 Arduino IDE 的语法高亮。
• library.properties: 库的属性文件，包含库的名称、版本等信息。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件通常是 examples/BasicUsage/BasicUsage.ino，这是一个 Arduino 的示例代码文件，展示了如何使用 WifiLocation 库进行地理位置定位。

#include <WifiLocation.h>

const char* googleApiKey = "YOUR_GOOGLE_API_KEY";
WifiLocation location(googleApiKey);

void setup() {
  Serial.begin(115200);
  WiFi.begin("SSID", "PASSWORD");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("Connected to WiFi");

  // Get location
  location_t loc = location.getGeoFromWiFi();

  Serial.println("Location request data");
  Serial.println(location.getSurroundingWiFiJson());
  Serial.println("Latitude: " + String(loc.lat, 7));
  Serial.println("Longitude: " + String(loc.lon, 7));
  Serial.println("Accuracy: " + String(loc.accuracy));
}

void loop() {
  // Your code here
}

3. 项目的配置文件介绍

项目的配置文件主要是 library.properties，它包含了库的基本信息，如名称、版本、作者等。

name=WifiLocation
version=1.3.0
author=Germán Martín
maintainer=Germán Martín
sentence=Library to get geographic position (lat, lon, accuracy) without GPS by listening surrounding WiFi networks.
paragraph=This library implements call to Google Maps GeoLocation API to get location from surrounding WiFi networks without the need to use a GPS receiver. It is not needed to know WiFi password of all of them. Internet connection is required. You need an API key from Google Maps.
category=Communication
url=https://github.com/gmag11/WifiLocation
architectures=esp8266,esp32

• name: 库的名称。
• version: 库的版本。
• author: 库的作者。
• maintainer: 库的维护者。
• sentence: 库的简短描述。
• paragraph: 库的详细描述。
• category: 库的分类。
• url: 库的 GitHub 地址。
• architectures: 支持的架构。

以上是 WifiLocation 项目的基本使用教程，希望对您有所帮助。

WifiLocationGoogle GeoLocation API wrapper for Arduino MKR1000, ESP8266 and ESP32项目地址:https://gitcode.com/gh_mirrors/wi/WifiLocation