Locathing SDK

Um SDK em Dart para serviços de busca de endereços e geocodificação.

Visão Geral

O Locathing SDK oferece uma maneira simples e eficiente de buscar endereços e informações de geocodificação usando nossa API REST.

Instalação

dependencies:
  locathing_sdk: ^1.0.1

Uso

import 'package:flutter_dotenv/flutter_dotenv.dart';
import 'package:locathing_sdk/locathing_sdk.dart';

Future<void> main() async {
  await dotenv.load(fileName: ".env");
  final apiKey = dotenv.env['LOCATHING_API_KEY'];
  if (apiKey == null || apiKey.isEmpty) {
    print("API key não encontrada no .env");
    return;
  }

  final client = LocathingClient(apiKey: apiKey);

  try {
    final (results, usage) = await client.search(
      query: 'Av Paulista',
      type: 'address',
      proximity: '-46.6388,-23.5489'
    );

    print('Resultados encontrados:');
    for (final r in results) {
      print('- ${r.name} (${r.address})');
      print('  Coordenadas: ${r.coordinates}');
      print('  Relevância: ${r.relevance}');
    }

    print('\nInformações de uso da API:');
    print('Plano: ${usage.plan}');
    print('Solicitações restantes: ${usage.remaining}');
  } catch (e) {
    print('Erro ao buscar: $e');
  }
}

Funcionalidades

  • Busca de endereços com pontuação de relevância
  • Geocodificação e geocodificação reversa
  • Busca baseada em proximidade
  • Monitoramento de uso e gerenciamento de cota

Autor

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para mais detalhes.

Libraries

locathing_sdk
Locathing SDK — cliente oficial para a API Locathing.