Addresses
Taxi & Private Hire › Products › Address › Addresses
Generally available
A resolved address with coordinates: postal components, lat/lng, providerId (Google Places ID where available), addressHash for dedup, regionCode for routing policy. Created at trip-creation time when an operator or customer picks a pickup or dropoff location. Persisted addresses serve future trip stops and feed the address-search cache.
Related
Fields
| Field | Type | Description |
|---|---|---|
latitude | decimal | Latitude of the resolved address (DECIMAL(9,6)). Drives the routing service routing, zone resolution, and H3 indexing. |
longitude | decimal | Longitude of the resolved address. Paired with `latitude`. |
address | string | Human-readable postal address string ("12 Main St, Dublin 2"). Display-only — coordinates are the source of truth for routing. |
clientId | bigint | Tenant scope. Every tenant-aware entity carries this; `ClientFilter` enforces row-level isolation on read; the multi-tenancy routing layer (`/client/{clientId}`) sets it at create time. Surfaced only under `admin` / `tripLog` groups — never to end users. |
internalKey | string | Optional client-supplied external reference / idempotency key. When present, lets external systems correlate platform-side records back to their own source-of-truth ids. Not persisted to a column — populated by the request handler when the caller sets it. |
__objectType | string | Discriminator string (entity class short-name) emitted alongside the id in serialized output. Resolved at read time by `getObjectType()`; lets the FE dispatch entity-specific rendering without inspecting the URL. |
id | bigint | Snowflake-style primary key (unsigned BIGINT). Generated by `IdFactory` at create time; surfaced to the FE / API as a `G`-prefixed string and stripped back to plain bigint server-side before Doctrine lookup. |
createdDate | integer | Unix timestamp the row was first persisted. Set in the entity's PrePersist hook; never rewritten on subsequent updates. |
updatedDate | integer | Unix timestamp the row was last touched. Bumped on every commit that hits the Doctrine UoW for this entity; drives FE invalidation + the listing change cursor. |
passiveUpdatedDate | int | Read-through alias for `updatedDate` exposed under different serializer groups. Lets the FE distinguish "real edit" from "background touch" projections without changing the underlying column. |
listingUpdatedDate | int | Listing-projection timestamp surfaced only under the `listMode` group. Driven by `TripCache` and other listing-shape refreshers separately from `updatedDate` so a listing rebuild doesn't trigger detail-page invalidation. |