Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spoleto-software/spoleto.addressresolver
The library for parsing textual representations of addresses. It is designed to break down an address into its components, such as city, street, house number, fias, kladr and postal codes. This simplifies the processing and validation of address information in various applications, such as delivery systems, CRM and geocoding.
https://github.com/spoleto-software/spoleto.addressresolver
address address-parser address-validation dadata dadata-client dotnet fias kladr
Last synced: about 1 month ago
JSON representation
The library for parsing textual representations of addresses. It is designed to break down an address into its components, such as city, street, house number, fias, kladr and postal codes. This simplifies the processing and validation of address information in various applications, such as delivery systems, CRM and geocoding.
- Host: GitHub
- URL: https://github.com/spoleto-software/spoleto.addressresolver
- Owner: spoleto-software
- License: mit
- Created: 2024-09-17T07:59:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-09-19T07:52:58.000Z (3 months ago)
- Last Synced: 2024-11-21T22:49:24.177Z (about 1 month ago)
- Topics: address, address-parser, address-validation, dadata, dadata-client, dotnet, fias, kladr
- Language: C#
- Homepage: https://spoleto.ru
- Size: 28.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Spoleto.AddressResolver
**Spoleto.AddressResolver** is a library for parsing textual representations of addresses. It is designed to break down an address into its components, such as city, street, house number, fias, kladr and postal code. This simplifies the processing and validation of address information in various applications, such as delivery systems, CRM, and geocoding.
## Features
- **Accurate Recognition**: Analyzes addresses in different formats, ensuring high accuracy in extracting components.
- **Support for Various Address Formats**: Capable of handling addresses in different standards and layouts.
- **Extensibility**: Easily add new rules and patterns to handle specific address formats via new resolvers.
- **Lightweight**: A low-resource library that can be integrated into projects with various requirements.
## Installation
To install the library, use the following package manager, for example, NuGet:
```bash
Install-Package Spoleto.AddressResolver
```
## Parsers
The parsers come as pre-configured NuGet packages:
- **[Spoleto.AddressResolver.Dadata](https://www.nuget.org/packages/Spoleto.AddressResolver.Dadata/)**: Parser via Dadata https://dadata.ru/;
## Usage
### Creating an address resolver
```csharp
var options = new DadataOptions { Token = "your-dadata-token" };
var addressResolver = new DadataAddressResolver(options);
```
### Resolve the string representation of the address:
```csharp
var address = await addressResolver.ResolveLocationAsync("Москва, Череповецкая 14");
// or sync version:
var address = addressResolver.ResolveLocation("Москва, Череповецкая 14");
```
### Suggest the string representation of the address:
```csharp
var suggestedAddresses = await addressResolver.SuggestLocationsAsync("Москва, Тверская-Ямская");
// or sync version:
var suggestedAddresses = addressResolver.SuggestLocations("Москва, Тверская-Ямская");
```