Géocoder - Amazon Location Service
Cas d’utilisationComprendre la demandeComprendre la réponse

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Géocoder

Le géocodage transforme les adresses textuelles ou les noms de lieux en coordonnées géographiques, ainsi que des composants d'adresse détaillés et des informations supplémentaires. Cette API prend en charge des requêtes flexibles, notamment du texte libre et des requêtes structurées avec des noms de rue, des codes postaux et des régions. Les fonctionnalités optionnelles incluent les données de fuseau horaire et les ajustements du point de vue politique.

Note

Les résultats enregistrés entraînent des tarifs de stockage plus élevés. Utilisez le IntendedUse paramètre pour indiquer un usage unique ou un stockage. Reportez-vous au Tarifs des places pour comprendre les implications financières pour les résultats stockés.

Pour plus d'informations, consultez Geocode dans le manuel Amazon Location Service API Reference.

Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, reportez-vous à la section Comment utiliser Geocode.

Cas d’utilisation

  • Ajoutez des données supplémentaires aux adresses des clients : améliorez les enregistrements d'adresses en incluant les codes postaux, les coordonnées et en utilisant le stockage permanent pour prendre des décisions commerciales et marketing éclairées.

  • Standardisation des données d'adresse : appliquez le géocodage dans des pipelines de données ou des processus par lots pour normaliser les données d'adresses, en utilisant le stockage permanent pour référence continue.

  • Déterminez les fuseaux horaires : identifiez le fuseau horaire des villes ou des adresses afin de fournir des horodatages précis pour les applications telles que les voyages, la planification et la facturation.

Comprendre la demande

La demande accepte des paramètres facultatifs, tels que AdditionalFeaturesBiasPosition, etFilter, pour affiner les résultats de recherche. Des options supplémentairesLanguage, telles queMaxResults, etPoliticalView, permettent de personnaliser davantage la réponse. Le paramètre requis estQuery, qui peut être fourni sous forme de texte libre ou structuré commeQueryComponents. Pour plus d'informations, reportez-vous à la référence de l'API Geocode.

La demande inclut les paramètres clés suivants :

Authentification

Pour l'authentification, le Key paramètre est facultatif si d'autres méthodes sont utilisées.

  • Key: paramètre facultatif pour l'authentification.

Pour de plus amples informations, consultez Authentifiez-vous auprès d'Amazon Location Service.

Interrogation et biais

Paramètres utilisés pour les requêtes et le biais géographique des résultats.

  • QueryText: requête de texte libre pour rechercher des emplacements.

  • QueryComponents: composants structurés tels que le numéro d'adresse, le pays, la localité ou le code postal pour une recherche précise.

  • BiasPosition: position géographique vers laquelle orienter les résultats de recherche.

Pour de plus amples informations, consultez Interrogation et biais.

Affiner les résultats

Appliquez des filtres pour affiner les résultats.

  • Filter: filtrez pour inclure des pays ou des types de lieux spécifiques. Pour de plus amples informations, veuillez consulter Le filtrage.

Internationalisation et localisation

Spécifiez la langue et appliquez un point de vue politique pour obtenir des résultats localisés.

  • Language: Langue des résultats.

  • PoliticalView: Applique une vision politique reflétant les revendications territoriales.

Pour de plus amples informations, consultez Localisation et internationalisation.

Fonctionnalités supplémentaires

Demandez des informations supplémentaires telles que les détails du fuseau horaire.

  • AdditionalFeatures: Possibilité de demander des informations supplémentaires telles que le fuseau horaire. Pour de plus amples informations, veuillez consulter Fonctionnalités supplémentaires.

Comprendre la réponse

La réponse fournitResultItems, qui contiennent des données de localisation détaillées telles queAddress,PlaceId,Position, et d'autres attributs pertinents. Des fonctionnalités supplémentaires telles que TimeZone des informations ou MatchScores pour chaque composant de requête peuvent également être incluses. Chacun ResultItem représente un emplacement correspondant ou un résultat de géocodage basé sur les paramètres de demande spécifiés. Pour plus de détails, consultez la référence de l'API Geocode.

La réponse inclut les paramètres clés suivants :

Adresse et informations connexes

Informations sur l'emplacement renvoyé, y compris les composants de l'adresse.

  • Address: Adresse complète, y compris le pays, la région, le code postal et les détails de la rue.

  • PostalCodeDetails: Informations supplémentaires relatives aux codes postaux.

  • StreetComponents: détails de la rue, y compris le nom et le type de base.

Types et catégories de lieux

Informations sur le type et la catégorie de place renvoyée.

  • Categories: Liste des catégories décrivant le lieu, par exemple restaurants, écoles.

  • PlaceType: Spécifie le type de lieu, tel que la ville, l'adresse ou la région.

Analyse des résultats

Scores indiquant dans quelle mesure les résultats correspondent à la requête d'entrée.

  • MatchScores: Scores pour la précision des correspondances.

    • Overall: mesure dans quelle mesure une recherche d'adresse correspond à votre saisie, sur une échelle de 0,0 à 1,0 (0 % à 100 %). Un score parfait de 1,0 signifie que chaque élément de votre recherche a été trouvé dans la base de données. Il est normal de voir des scores inférieurs lorsque vous incluez des détails supplémentaires tels que les noms des contacts ou les instructions de livraison. Cela réduit naturellement le score, mais ne signifie pas nécessairement que l'adresse est erronée.

    • Component Score: Chaque composant d'adresse (tel que AddressNumber ouPostalCode) est noté individuellement sur une échelle de 0,0 à 1,0 (0 % à 100 %). Ces scores indiquent avec quelle précision chaque partie de l'adresse correspond au résultat. Par exemple, si AddressNumberStreet, et PostalCode un score proche de 1,0, vous pouvez faire confiance à la correspondance même si le score global est inférieur en raison d'autres détails de la requête.

    Note

    Lorsqu'aucun score n'apparaît pour un composant spécifique (tel queStreet), ce composant est compté pour 0. Cela permet d'identifier les parties de l'adresse susceptibles de nécessiter une vérification.

    Ce système de notation permet de trouver un équilibre entre des correspondances exactes et une facilité d'utilisation pratique lorsqu'il s'agit de recherches d'adresses réelles qui incluent souvent des informations supplémentaires.

Détails supplémentaires

Inclut des informations supplémentaires relatives à la localisation selon les besoins.

  • AccessPoints: coordonnées géographiques représentant les points d'accès.

  • TimeZone: informations sur le fuseau horaire du lieu.