Google Maps URL Extractor

A Dart package for extracting coordinates from Google Maps URLs and expanding shortened URLs.

Features

  • Expand shortened Google Maps URLs (e.g., goo.gl links)
  • Extract latitude and longitude coordinates from Google Maps URLs
  • Support for various Google Maps URL formats
  • Asynchronous processing of URLs

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  google_maps_url_extractor: ^1.0.1

or run

flutter pub add google_maps_url_extractor

Usage

  1. Import the package in your Dart/Flutter code
import 'package:google_maps_url_extractor/google_maps_url_extractor.dart';

void main() async {
  final url = 'https://maps.app.goo.gl/mWtb4a1cUE9zMWya7';
  final coordinates = await GoogleMapsUrlExtractor.processGoogleMapsUrl(url);
}
  1. Use the expandShortUrl method to expand the shortened URL
final expandedUrl = await GoogleMapsUrlExtractor.expandShortUrl(url);
  1. Use the extractCoordinates method to get the coordinates from the URL
final url = 'https://www.google.com/maps/@37.7749,-122.4194,15z';
final coordinates = GoogleMapsUrlExtractor.extractCoordinates(url);
if (coordinates != null) {
print('Latitude: ${coordinates['latitude']}');
print('Longitude: ${coordinates['longitude']}');
}
  1. Use the processGoogleMapsUrl method to get the coordinates from the 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']}');
}

Supported URL Formats

This package supports various Google Maps URL formats, including:

  • Short URLs (e.g., https://goo.gl/maps/abcdefg)
  • Standard map URLs (e.g., https://www.google.com/maps/@37.7749,-122.4194,15z)
  • Place URLs (e.g., https://www.google.com/maps/place/Eiffel+Tower/@48.8583701,2.2922926,17z)
  • Search URLs (e.g., https://www.google.com/maps/search/?api=1&query=48.8583701,2.2922926)
  • Direction URLs (e.g., https://www.google.com/maps/dir/?api=1&destination=48.8583701,2.2922926)

Error Handling

All methods return null if the input URL is invalid or if coordinates cannot be extracted.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Libraries

google_maps_url_extractor
url_extractor