Surveillez l'utilisation de votre clé avant d'atteindre une limite
Surveiller vos en-têtes de quota au fil de l'eau vous indique quand une limite approche, bien avant qu'une requête ne soit effectivement refusée.
Géocoder des adresses qui comportent un numéro d'appartement ou de logement
Un numéro d'appartement ajouté à une adresse postale fait tout naturellement partie de beaucoup d'adresses réelles, et il vaut la peine de comprendre comment une recherche de géocodage le traite plutôt que de le supprimer avant d'envoyer la requête, une habitude courante mais inutile.
Envoyer l'adresse complète
Incluez le numéro d'appartement ou de logement dans la requête en texte libre, comme n'importe quelle autre partie de l'adresse.
GET /v1/forward?q=Apt 4B, 350 Fifth Avenue, New York&limit=1{
"status": "ok",
"query": "Apt 4B, 350 Fifth Avenue, New York",
"results": [
{
"formatted": "350 Fifth Avenue, New York, NY",
"lat": 40.7484,
"lon": -73.9857,
"type": "address",
"precision": "house",
"confidence": 0.95,
"place_id": "es234",
"components": {"house_number": "350", "street": "Fifth Avenue", "city": "New York", "region": "NY", "country": "US"}
}
]
}Pourquoi le numéro de logement n'apparaît pas dans les coordonnées
Les coordonnées issues d'une recherche de géocodage identifient un bâtiment, pas un logement précis à l'intérieur, car les appartements n'ont pas leur propre emplacement cartographié distinct comme un bâtiment. La partie appartement ou logement d'une adresse n'est pas censée modifier les valeurs lat et lon, et son absence de l'objet components est elle aussi normale : ce n'est pas le signe que la saisie a été ignorée ou mal traitée.
Un second exemple : un numéro de bureau dans un immeuble commercial
Le même principe s'applique à une adresse professionnelle comportant un numéro de bureau ou d'étage.
GET /v1/forward?q=Suite 200, 1 Example Plaza, Chicago&limit=1Un grand immeuble de bureaux abritant des dizaines d'entreprises distinctes se géocode toujours vers un seul jeu de coordonnées de bâtiment, quel que soit le bureau indiqué dans la requête, exactement comme un immeuble d'habitation. Tout ce qui distingue un occupant d'un autre dans ce bâtiment doit figurer dans vos propres données, pas dans les coordonnées.
Une erreur courante à éviter
N'essayez pas de contourner l'absence du composant de logement en l'ajoutant vous-même après coup au code postal ou à un autre champ de composant, par exemple en écrivant un code postal sous la forme « 20500 Apt 4B ». Cela corrompt un champ dont d'autres systèmes, y compris votre propre validation et toute recherche d'adresse en aval, attendent qu'il contienne uniquement un vrai code postal. Conservez le numéro de logement dans son propre champ, entièrement séparé de chaque composant géocodé.
Stocker le numéro de logement séparément
Plutôt que d'intégrer le numéro de logement dans la chaîne d'adresse que vous géocodez à chaque fois, stockez-le comme un champ distinct dans votre propre modèle de données, à côté de l'adresse géocodée du bâtiment. La requête de géocodage reste ainsi centrée sur ce qui influe réellement sur le résultat, l'emplacement du bâtiment, tout en préservant l'information de logement pour les étiquettes de livraison ou les dossiers internes.
Quand cela compte pour la livraison
Un coursier ou un service postal a besoin du numéro de logement pour la livraison elle-même, même s'il n'a joué aucun rôle dans les coordonnées. Conservez les deux éléments, les coordonnées géocodées du bâtiment et le numéro de logement stocké séparément, ensemble dans la fiche de livraison finale afin que rien ne se perde en route.
Un cas limite à connaître
Une seule adresse de bâtiment peut abriter un grand nombre de résidents ou d'occupants distincts, qui partagent tous les mêmes coordonnées et le même résultat de recherche de code postal. Si vous comparez le code postal d'un client à une adresse obtenue par géocodage direct, comme l'explique le guide de vérification croisée des codes postaux, rappelez-vous que cette relation de plusieurs logements pour un bâtiment est normale et ne constitue pas en soi le signe d'un problème de données.
Le coût ne change pas
Qu'une adresse comporte ou non un numéro d'appartement ou de logement, la recherche coûte toujours une requête, comme tout autre appel de géocodage direct.
Inclure un numéro de logement dans la requête ne pose aucun problème, et le supprimer n'est pas nécessaire pour un géocodage précis, mais le placer ensuite dans son propre champ stocké garde vos données plus propres. Consultez la documentation du géocodage direct pour la liste complète des composants.