Raccourcir Plus Code

Les Open Location Codes, mieux connus sous le nom de Plus Codes, transforment latitude et longitude en chaînes courtes que l’on peut dicter, saisir et imprimer sans numéros de rue. Ce raccourcisseur de Plus Code accepte un code complet valide plus une latitude et une longitude de référence proches, mesure la proximité de la référence au centre de la cellule, et supprime autant de paires de caractères initiales que la règle de sécurité de l’Open Location Code le permet. Le résultat est un code court compact prêt à être associé à un nom de lieu, tandis que l’API indique aussi si un raccourcissement a eu lieu, combien de caractères ont été retirés et la plage angulaire utilisée. Codes complets invalides, codes de zone avec remplissage et coordonnées manquantes échouent avec des erreurs invalid_input claires plutôt que d’inventer un fragment ambigu.

Comment fonctionne le raccourcissement du Plus Code par rapport à un lieu de référence

Les dix premiers chiffres significatifs forment des paires de latitude et de longitude qui raffinent la cellule par facteurs successifs de vingt ; des chiffres de grille optionnels après le séparateur raffinent encore. Le raccourcissement ne se contente pas de retirer un préfixe fixe : il décode le code complet jusqu’au centre de sa cellule, compare ce centre à votre latitude et longitude de référence avec une métrique de Chebyshev (le maximum des écarts absolus de latitude et de longitude en degrés), et parcourt une table fixe de résolutions de vingt, un, zéro virgule zéro cinq, zéro virgule zéro zéro deux cinq et zéro virgule zéro zéro zéro un deux cinq degrés.

Contrat d’entrée, forme de la réponse et comportement d’erreur

Les codes avec un remplissage de zéros avant le séparateur sont rejetés avec un message indiquant qu’ils ne peuvent pas être raccourcis. Champs manquants, chaînes vides et nombres non finis échouent avec des messages qui nomment le champ et ne sont pas facturés. Associez le code court à une chaîne de localité dans votre propre interface ; ce point de terminaison n’émet jamais de noms de ville. Envoyez par POST un corps JSON avec trois champs obligatoires : code, une chaîne Open Location Code complète telle que eight F V C nine G eight F plus six X ; latitude, une latitude de référence finie en degrés décimaux signés ; et longitude, une longitude de référence finie en degrés décimaux signés. Des alias sont acceptés pour la commodité : plus_code, olc, full_code ou location_code pour le code ; lat, ref_latitude ou reference_latitude pour la latitude ; lon, lng, ref_longitude ou reference_longitude pour la longitude. Le code est rogné et passé en majuscules ; les codes courts (séparateur avant la position huit) et les chaînes qui échouent aux règles de validité de l’Open Location Code sont rejetés avec invalid_input en nommant le champ. La latitude est bornée à l’intervalle fermé de moins quatre-vingt-dix à quatre-vingt-dix ; la longitude est normalisée dans l’intervalle semi-ouvert de moins cent quatre-vingts à cent quatre-vingts. En cas de succès le corps renvoie le code complet normalisé et les coordonnées nettoyées, short_code (qui peut égaler le code complet lorsqu’aucun découpage sûr n’est possible), was_shortened en booléen, characters_removed en entier non négatif, code_length comme le nombre de chiffres significatifs de l’entrée, short_length comme celui de la forme courte, range_degrees comme la plage de Chebyshev arrondie pour des goldens stables, et method égal à olc_shorten. Exemple : le code eight F V C nine G eight F plus six X avec latitude de référence quarante-sept point cinq et longitude huit point cinq produit le code court nine G eight F plus six X après suppression des quatre premiers caractères.

Où un raccourcisseur de Plus Code prouve son utilité

Comme l’implémentation est un parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez les requêtes compactes, figez short_code et characters_removed dans les tests, et vous obtenez des Plus Codes courts reproductibles pour étiquettes, bots de chat et edge workers sans déployer d’infrastructure de géocodage propre.