# Location

> merchant.location est un objet ou null, jamais absent. Ses deux champs, les formes possibles, et pourquoi la localisation ne reprend jamais le pays de votre requête.

`merchant.location` dit où se trouve le point de vente reconnu, quand Noryo le sait. **La clé est toujours présente** dès que `merchant` est un objet : soit un objet, soit `null`.

## Les formes possibles

```json
"location": { "city": "PARIS", "postal_code": "75018" }
"location": { "city": "MULHOUSE" }
"location": null
```

| Champ | Type | Présence |
|---|---|---|
| `city` | chaîne | omis s'il est inconnu |
| `postal_code` | chaîne | omis s'il est inconnu |

Un objet porte au moins l'un des deux champs : Noryo ne rend jamais d'objet vide, qui ferait croire à une adresse connue mais illisible. Sans ville ni code postal, `location` vaut `null`.

## Pourquoi `null` plutôt qu'absente

Absent et inconnu se ressemblent trop pour qu'on vous demande de les distinguer. Avec une clé toujours présente, un seul test suffit :

```ts
const loc = body.merchant?.location ?? null;
if (loc === null) {
  // localisation inconnue
} else {
  const city = loc.city ?? null;          // peut manquer
  const postalCode = loc.postal_code ?? null;
}
```

## Ce que `location` n'est pas

- **Ce n'est pas votre `country`.** Le `country` de la requête entre dans l'identité économique, mais il n'est jamais recopié dans `location` : présenter une entrée du client comme une donnée résolue par Noryo serait trompeur. Il ne filtre pas non plus la résolution. Voir [Lire une réponse](https://developer.noryo.app/fr-FR/merchant/reading-the-response).
- **Ce n'est pas une adresse complète.** Seuls `city` et `postal_code` sont publics ; aucun autre champ (coordonnées, rue, identifiant d'établissement) n'en sort.
- **Ce n'est pas une condition de `resolved`.** La politique de résolution en vigueur n'exige pas de localisation : un résultat `resolved` peut avoir `location: null`. Une politique qui l'exigerait rendrait `partial` avec la raison `location_required`.

## Les valeurs

Les valeurs sont rendues telles que le catalogue de Noryo les connaît, par exemple une ville en majuscules (`PARIS`). Appliquez votre propre mise en forme à l'affichage.

---

Page canonique : https://developer.noryo.app/fr-FR/merchant/models/location