Récupérez un code Plus raccourci avec des coordonnées proches
Un code Plus raccourci est pratique lorsque la zone générale est déjà connue, mais il ne permet pas d’identifier seul un lieu.
Lancer gratuitement
Cet outil rétablit le préfixe manquant en associant l’Open Location Code court à une latitude et une longitude de référence proches. Il renvoie le code complet récupéré, les coordonnées de son centre ainsi que les limites de latitude et de longitude de la zone encodée. Le calcul est déterministe, ne consulte aucune carte et respecte les règles de sélection des cellules d’Open Location Code.
Pourquoi un code Plus raccourci exige un point de référence
Un code Plus complet commence par des caractères qui situent une vaste zone, puis utilise des caractères de plus en plus précis. Un code raccourci supprime volontairement une partie de ce préfixe général, car les personnes qui l’échangent connaissent déjà la ville, le quartier ou un repère proche. Une pancarte ou un message local peut, par exemple, n’afficher que quelques caractères avant le signe plus. Les caractères conservés décrivent des cellules de grille qui se répètent dans le monde entier : le texte seul est donc ambigu. La récupération apporte le contexte manquant sous la forme d’une latitude et d’une longitude de référence. Le calculateur encode d’abord ces coordonnées proches avec la précision standard par paires, prélève exactement autant de caractères initiaux que le code court en a omis, puis rattache ce préfixe au code fourni. Il compare ensuite le centre de la cellule obtenue au point de référence. Cette opération ne recherche ni adresse, ni commerce, ni route, ni division administrative. Elle rétablit l’Open Location Code complet géographiquement le plus proche qui soit compatible avec le texte raccourci et les coordonnées indiquées. Une référence située dans la même localité constitue donc une donnée indispensable, et non un simple conseil facultatif destiné à améliorer la précision.
Comment le code correspondant le plus proche est sélectionné
Il suffit généralement de copier un préfixe issu des coordonnées de référence, mais les emplacements proches de la limite d’une cellule demandent une étape supplémentaire. Le code complet provisoire est décodé en une zone rectangulaire dotée d’un centre et de limites au nord, au sud, à l’est et à l’ouest. Le calculateur détermine la résolution du préfixe omis et compare le centre provisoire à la référence. Si ce centre se trouve à plus de la moitié de cette résolution, le candidat est déplacé d’une cellule équivalente vers la référence, sans dépasser les limites de latitude aux pôles. La longitude est normalisée au passage de l’antiméridien : un point voisin situé de l’autre côté des 180 degrés ne provoque donc pas de résultat éloigné. Le code final est décodé une nouvelle fois et renvoyé avec ses limites et coordonnées centrales explicites. Cette méthode applique l’interprétation de la zone compatible la plus proche prévue pour un code Plus court. Elle ne prétend pas que le centre corresponde à l’entrée d’un bâtiment ni que tous les points de la cellule partagent la même adresse postale. Les limites décrivent la zone de grille encodée, tandis que le code complet est l’identifiant portable que vous pouvez conserver ou transmettre à une autre implémentation d’Open Location Code.
Choisir les coordonnées et interpréter le résultat
Utilisez des coordonnées réellement proches de l’endroit où le code court a été créé. Le centre d’une commune, un point de passage déjà connu ou la position GPS actuelle conviennent s’ils se situent dans la même zone. Plus le code est raccourci, plus son préfixe géographique perd de caractères et plus la proximité de la référence devient importante : une référence imprécise ou éloignée peut sélectionner une autre cellule répétée qui correspond elle aussi aux caractères restants. Après la récupération, examinez à la fois full_code et le centre renvoyé. Les champs latitude_lo, latitude_hi, longitude_lo et longitude_hi indiquent le rectangle exact encodé par le résultat et servent à cadrer une carte ou à vérifier l’inclusion d’un point. Conservez le code court d’origine et les coordonnées de référence dans votre journal d’audit lorsque la reproductibilité compte, car le résultat complet dépend des deux. Les entrées s’expriment en degrés décimaux ; la latitude doit rester comprise entre les pôles et la longitude dans la plage signée habituelle. L’opération n’utilise ni service réseau, ni base cartographique, ni heure actuelle, ni choix aléatoire. Une même entrée valide produit donc toujours le même code et la même zone numérique, en utilisation interactive comme dans un flux automatisé facturé $0.002 par requête.
Cas d’usage
Compléter un code reçu dans un message local
Associez un code court de quartier à des coordonnées proches connues avant de le conserver ou de le partager partout dans le monde.
Normaliser des relevés de terrain
Transformez des codes raccourcis et leurs coordonnées de référence en identifiants complets assortis de limites décodées explicites.
Préparer des données de navigation pour un autre système
Récupérez des codes complets portables avant d’exporter des points de passage vers un logiciel qui refuse les codes Plus raccourcis.
Questions fréquentes
Que faut-il pour récupérer un code Plus raccourci ?
Fournissez le code court ainsi qu’une latitude et une longitude proches en degrés décimaux. Les trois valeurs sont nécessaires, car le préfixe omis représente le contexte géographique.
À quelle distance les coordonnées de référence peuvent-elles se trouver ?
Elles doivent appartenir à la même localité que le lieu recherché. Plus le code omet de caractères, plus une référence véritablement proche est importante.
Cet outil peut-il retrouver une adresse ou le nom d’un lieu ?
Non. Il effectue uniquement les calculs d’Open Location Code et ne consulte ni cartes, ni géocodeurs, ni annuaires commerciaux, ni bases postales.
Pourquoi les limites accompagnent-elles le code complet ?
Un code Plus représente une zone, et non un point infiniment précis. Les limites et le centre rendent ce rectangle encodé explicite.
Puis-je envoyer un code Plus déjà complet ?
Non. Cette capacité récupère précisément les codes raccourcis et rejette tout code dont le signe plus occupe déjà la position d’un code complet.
Combien coûte une requête API ?
Chaque requête API coûte $0.002. La version pour navigateur s’exécute localement sans transmettre le calcul à un service cartographique.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/geo/plus-code-recover \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}'const res = await fetch("https://api.kit.forhosting.com/geo/plus-code-recover", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/plus-code-recover",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/plus-code-recover", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/plus-code-recover", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.plus_code_recover",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |