Flutter谷歌地图URL解析插件google_maps_url_extractor的使用

Google Maps URL Extractor 是一个用于从 Google 地图 URL 中提取坐标的 Dart 包，并支持扩展缩短的 URL。

特性

• 扩展缩短的 Google 地图 URL（例如，goo.gl 链接）
• 从 Google 地图 URL 中提取纬度和经度坐标
• 支持各种 Google 地图 URL 格式
• 异步处理 URL

安装

在您的 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  google_maps_url_extractor: ^1.0.1

或者运行以下命令：

flutter pub add google_maps_url_extractor

使用

1. 导入包

在您的 Dart/Flutter 代码中导入该包：

import 'package:google_maps_url_extractor/google_maps_url_extractor.dart';

2. 扩展缩短的 URL

使用 expandShortUrl 方法来扩展缩短的 URL：

final shortUrl = 'https://maps.app.goo.gl/mWtb4a1cUE9zMWya7';
final expandedUrl = await GoogleMapsUrlExtractor.expandShortUrl(shortUrl);
print('Expanded URL: $expandedUrl');

3. 提取坐标

使用 extractCoordinates 方法从 URL 中获取坐标：

final fullUrl = 'https://www.google.com/maps/@37.7749,-122.4194,15z';
final coordinates = GoogleMapsUrlExtractor.extractCoordinates(fullUrl);
if (coordinates != null) {
  print('Latitude: ${coordinates['latitude']}');
  print('Longitude: ${coordinates['longitude']}');
}

4. 处理 Google 地图 URL

使用 processGoogleMapsUrl 方法从 URL 中获取坐标：

final url = 'https://maps.app.goo.gl/mWtb4a1cUE9zMWya7';
final coordinates = await GoogleMapsUrlExtractor.processGoogleMapsUrl(url);
if (coordinates != null) {
  print('Latitude: ${coordinates['latitude']}');
  print('Longitude: ${coordinates['longitude']}');
}

支持的 URL 格式

此包支持多种 Google 地图 URL 格式，包括：

• 缩短的 URL（例如：https://goo.gl/maps/abcdefg）
• 标准地图 URL（例如：https://www.google.com/maps/@37.7749,-122.4194,15z）
• 地点 URL（例如：https://www.google.com/maps/place/Eiffel+Tower/@48.8583701,2.2922926,17z）
• 搜索 URL（例如：https://www.google.com/maps/search/?api=1&query=48.8583701,2.2922926）
• 方向 URL（例如：https://www.google.com/maps/dir/?api=1&destination=48.8583701,2.2922926）

错误处理

所有方法在输入 URL 无效或无法提取坐标时返回 null。

示例 Demo

以下是一个完整的示例 Demo：

import 'package:google_maps_url_extractor/google_maps_url_extractor.dart';

void main() async {
  // Example of expanding a short URL
  const shortUrl = 'https://maps.app.goo.gl/mWtb4a1cUE9zMWya7';
  final expandedUrl = await GoogleMapsUrlExtractor.expandShortUrl(shortUrl);
  print('Expanded URL: $expandedUrl');

  // Example of extracting coordinates from a full URL
  const fullUrl =
      'https://www.google.com/maps/place/Moonraft+Innovation+Labs/@12.9140057,77.6281936,17z/data=!3m1!4b1!4m6!3m5!1s0x3bae148db555a135:0xdf658e2653660ee6!8m2!3d12.9140057!4d77.6281936!16s%2Fg%2F1tg66jp9?entry=ttu&g_ep=EgoyMDI0MDkxMS4wIKXMDSoASAFQAw%3D%3D';
  final coordinates = GoogleMapsUrlExtractor.extractCoordinates(fullUrl);
  if (coordinates != null) {
    print('Latitude: ${coordinates['latitude']}');
    print('Longitude: ${coordinates['longitude']}');
  } else {
    print('Failed to extract coordinates');
  }

  // Example of processing a Google Maps URL
  final processedCoordinates =
      await GoogleMapsUrlExtractor.processGoogleMapsUrl(shortUrl);
  if (processedCoordinates != null) {
    print('Processed Latitude: ${processedCoordinates['latitude']}');
    print('Processed Longitude: ${processedCoordinates['longitude']}');
  } else {
    print('Failed to process URL');
  }
}