Skip to main content

📍 Places Overview

The Places module provides a powerful and developer-friendly way to interact with Google Places APIs.

It allows you to search, autocomplete, and retrieve rich details about places using clean, strongly-typed abstractions.

🚀 What You Can Do​

  • 🔎 Search places by text or location
  • ✍️ Autocomplete user input with real-time suggestions
  • 📍 Retrieve detailed place information
  • 📸 Fetch place photos with configurable resolution
  • ⭐ Access user reviews and AI summaries

🧩 Architecture​

The module is built around a set of focused services:

  • IAutocompleteService → Suggestions based on partial input
  • ISearchService → Text and nearby search capabilities
  • IDetailsService → Rich place data (details, photos, reviews)
  • IPlacesService → Unified entry point for all services

👉 See: Abstractions

⚡ Quick Example​

var services = new ServiceCollection();

services.AddD3lg4doMaps(new MapsConfiguration {
    ApiKey = "YOUR_API_KEY"
});
services.AddD3lg4doMapsPlaces();

var provider = services.BuildServiceProvider();
var places = provider.GetRequiredService<IPlacesService>();

var results = await places.Search.SearchByTextAsync("coffee near Medellin");

🧠 Design Highlights​

  • Clean separation of concerns across services
  • Strongly-typed models for safer development
  • Fluent builders for complex request construction
  • Extensible and testable architecture
  • Async-first for performance and scalability

🔗 Next Steps​

💡 When to Use What?​

  • Use Autocomplete for user input assistance
  • Use Search for discovering places
  • Use Details for rich, in-depth information