Address data ready for your system

Address Geocoding API

Convert addresses into coordinates and normalized data for logistics, e-commerce, CRM and spatial analysis.

Single and batch requestsForward and reverse geocodingMatch quality in the response
Domaniewska 37, Warszawa52.18284, 21.0071318

From text to decisions

An address alone does not tell a system where something is

Geocoding adds a spatial layer to address data. It makes distance calculations, routing, service-area analysis and map presentation possible.

01

Data ready for action

Turn an address into coordinates for a map, CRM, delivery plan or coverage analysis.

02

Fewer manual corrections

Normalize different ways of writing cities, streets and building numbers before downstream processing.

03

Better spatial decisions

Assign customers to branches and work with a point rather than an unstructured text value.

A simple flow

From address to point in three steps

The same pattern works in a form, a data import and an automated backend integration.

  1. 1

    Send the address

    The address object must include city. country and street are optional; missing or null country defaults to PL. pcode and house can help narrow the match.

  2. 2

    Receive the match

    The API returns coordinates, a normalized address and information that helps assess the match.

  3. 3

    Use the point

    Store it, show it on a map or pass it to routes, matrices and spatial analyses.

From use case to contract

Geocode an address and use the returned point

Send a structured address, assess quality and resultRadius, then use the coordinates in a map, route or delivery workflow.

  • Geocoder.geocode for single addresses
  • Geocoder.geocodemulti for batches
  • Geocoder.revgeocode for coordinates
  • quality and resultRadius interpretation
Open geocoding reference
cURL
curl -X POST https://api.automapa.com/v3/Geocoder/geocode \
  -H "Content-Type: application/json" \
  -H "Session-Id: $AUTOMAPA_SESSION" \
  -d '{
    "address": {
      "country": "PL",
      "city": "Warszawa",
      "street": "Domaniewska",
      "house": "37",
      "maxResult": 1
    }
  }'
200 OK — full response envelope{ "result": [ { "quality": 9, "x": 21.0071318, "y": 52.18284, "city": "Warszawa", "street": "Domaniewska", "house": "37", "resultRadius": 0 } ] }Example values illustrate the response format. Coordinates and address data depend on the input and current map data.

Methods and related services

Geocoding is often the first stage of a larger process

The resulting point can feed suggestions, reverse geocoding, routes, matrices and road analysis.

Batch geocoding

Geocoder.geocodemulti

Process multiple addresses in one request.

Documentation

Reverse geocoding

Geocoder.revgeocode

Convert coordinates into the closest readable address.

Documentation

Address suggestions

Autocomplete.searchAddress

Help users enter a consistent address before geocoding.

Documentation

Routes and matrices

Routes.route / Routes.matrix

Use geocoded points to calculate travel times and distances.

Documentation

Use cases

Geocoding is part of a process, not the final goal

Logistics

Prepare pickup and delivery addresses for route calculation and delivery planning.

E-commerce

Verify order locations and reduce manual address correction.

Sales networks

Find the nearest branch and assign customers to regions.

Data quality

Normalize historical address databases before migration or analysis.

Common questions

Geocoding basics before integration

What is geocoding?

Geocoding converts an address description into geographic coordinates that can be mapped or used in location processes.

Which fields are required?

The address object and its city field are required for each address, including batches. country and street are optional; missing or null country defaults to PL. pcode and house can improve precision.

How can I assess the result?

The response includes match quality and result radius. The documentation explains how to interpret them for different use cases.

Can I process many addresses?

Yes. Geocoder.geocodemulti is intended for batches of addresses.

Does the preview call the production API?

No. It presents an example response; the documentation shows how to make an authenticated API request.