@azure-rest/maps-search package

Adresse du résultat

GeoJSON GeocodingFeature objet qui décrivent les limites d’une zone géographique. La géométrie de la fonctionnalité est décrite avec GeoJSON GeometryCollection.

Notez que le service retourne généralement une GeometryCollection avec des sous-types Polygon ou MultiPolygon.

Propriétés d’un objet Boundary.

Informations supplémentaires sur l’erreur de gestion des ressources.

Détail de l’erreur.

Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

Type d’objet GeoJSON FeatureCollection valide. Pour plus d’informations, reportez-vous à RFC 7946.

Type d’objet GeoJSON Feature valide. Pour plus d’informations, reportez-vous à RFC 7946.

Type d’objet GeoJSON GeometryCollection valide. Pour plus d’informations, reportez-vous à RFC 7946.

Objet geometry GeoJSON valide. Le type doit être l’un des sept types de géométrie GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, reportez-vous à RFC 7946.

Type de géométrie GeoJSON LineString valide. Pour plus d’informations, reportez-vous à RFC 7946.

Type de géométrie GeoJSON MultiLineString valide. Pour plus d’informations, reportez-vous à RFC 7946.

Données contenues dans un GeoJson MultiPoint.

Type de géométrie GeoJSON MultiPoint valide. Pour plus d’informations, reportez-vous à RFC 7946.

Type d’objet GeoJSON MultiPolygon valide. Pour plus d’informations, reportez-vous à RFC 7946.

Objet GeoJSON valide. Pour plus d’informations, reportez-vous à RFC 7946.

Données contenues dans un GeoJson Point.

Type de géométrie GeoJSON Point valide. Pour plus d’informations, reportez-vous à RFC 7946.

Type de géométrie GeoJSON Polygon valide. Pour plus d’informations, reportez-vous à RFC 7946.

Liste des requêtes/requêtes de géocodage d’adresses à traiter. La liste peut contenir un maximum de 100 requêtes et doit contenir au moins 1 requête.

Objet Batch Query

Cet objet est retourné à partir d’un appel de service Batch de géocodage réussi.

Résumé de la demande de traitement par lots

Cet objet est retourné à partir d’un appel de géocodage réussi

Informations de copyright d’une géométrie d’un objet Boundary.

Adresse du résultat.

Liste des requêtes/requêtes de géocodage inversées à traiter. La liste peut contenir un maximum de 100 requêtes et doit contenir au moins 1 requête.

Objet Batch Query

géocodage

S’applique à : consultez les niveaux de tarification .

Dans de nombreux cas, le service de recherche complet peut être trop important, par exemple si vous n’êtes intéressé que par le géocodage traditionnel. Vous pouvez également accéder à la recherche d’adresses exclusivement. Le géocodage est effectué en appuyant sur le point de terminaison de géocodage avec uniquement l’adresse ou l’adresse partielle en question. L’index de recherche de géocodage sera interrogé pour tous les éléments au-dessus des données au niveau de la rue. Aucun point d’intérêt (POI) n’est retourné. Notez que le géocodeur est très tolérant aux fautes de frappe et aux adresses incomplètes. Il gérera également tout à partir d’adresses de rue exactes ou de rues ou d’intersections ainsi que des zones géographiques de niveau supérieur telles que les centres urbains, les comtés, les états, etc.

l’API Batch de géocodage par lots

S’applique à: consultez les niveaux de tarification .

L’API Batch de géocodage envoie des lots de requêtes à 'API De géocodage à l’aide d’un seul appel d’API. L’API permet à l’appelant de traiter jusqu’à 100 requêtes.

Envoyer une demande de traitement par lots synchrone

L’API synchrone est recommandée pour les requêtes par lots légères. Lorsque le service reçoit une demande, il répond dès que les éléments de lot sont calculés et il n’y aura aucune possibilité de récupérer les résultats ultérieurement. L’API synchrone retourne une erreur de délai d’expiration (réponse 408) si la requête prend plus de 60 secondes. Le nombre d’éléments de lot est limité à 100 pour cette API.

POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01

Corps POST pour la requête Batch

Pour envoyer le géocodage requêtes, vous utiliserez une requête POST où le corps de la requête contiendra le tableau batchItems au format json et l’en-tête Content-Type sera défini sur application/json. Voici un exemple de corps de requête contenant 2 géocodage requêtes :

{
  "batchItems": [
    {
      "addressLine": "One, Microsoft Way, Redmond, WA 98052",
      "top": 2
    },
    {
      "addressLine": "Pike Pl",
      "adminDistrict": "WA",
      "locality": "Seattle",
      "top": 3
    }
  ]
}

Un objet géocodage batchItem peut accepter l’un des paramètres de géocodage pris en charge.

Le lot doit contenir au moins 1 requête.

Modèle de réponse par lot

La réponse par lot contient un composant summary qui indique les totalRequests qui faisaient partie de la demande de lot d’origine et successfulRequests c’est-à-dire les requêtes qui ont été exécutées avec succès. La réponse par lot inclut également un tableau batchItems qui contient une réponse pour chaque requête dans la requête de lot. Les batchItems contiennent les résultats dans le même ordre que les requêtes d’origine ont été envoyées dans la requête de lot. Chaque élément est de l’un des types suivants :

• GeocodingResponse : si la requête s’est terminée correctement.

• Error : si la requête a échoué. La réponse contient une code et une message dans ce cas.

l’API Batch de géocodage par lots

S’applique à: consultez les niveaux de tarification .

L’API Batch de géocodage envoie des lots de requêtes à 'API De géocodage à l’aide d’un seul appel d’API. L’API permet à l’appelant de traiter jusqu’à 100 requêtes.

Envoyer une demande de traitement par lots synchrone

L’API synchrone est recommandée pour les requêtes par lots légères. Lorsque le service reçoit une demande, il répond dès que les éléments de lot sont calculés et il n’y aura aucune possibilité de récupérer les résultats ultérieurement. L’API synchrone retourne une erreur de délai d’expiration (réponse 408) si la requête prend plus de 60 secondes. Le nombre d’éléments de lot est limité à 100 pour cette API.

POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01

Corps POST pour la requête Batch

Pour envoyer le géocodage requêtes, vous utiliserez une requête POST où le corps de la requête contiendra le tableau batchItems au format json et l’en-tête Content-Type sera défini sur application/json. Voici un exemple de corps de requête contenant 2 géocodage requêtes :

{
  "batchItems": [
    {
      "addressLine": "One, Microsoft Way, Redmond, WA 98052",
      "top": 2
    },
    {
      "addressLine": "Pike Pl",
      "adminDistrict": "WA",
      "locality": "Seattle",
      "top": 3
    }
  ]
}

Un objet géocodage batchItem peut accepter l’un des paramètres de géocodage pris en charge.

Le lot doit contenir au moins 1 requête.

Modèle de réponse par lot

La réponse par lot contient un composant summary qui indique les totalRequests qui faisaient partie de la demande de lot d’origine et successfulRequests c’est-à-dire les requêtes qui ont été exécutées avec succès. La réponse par lot inclut également un tableau batchItems qui contient une réponse pour chaque requête dans la requête de lot. Les batchItems contiennent les résultats dans le même ordre que les requêtes d’origine ont été envoyées dans la requête de lot. Chaque élément est de l’un des types suivants :

• GeocodingResponse : si la requête s’est terminée correctement.

• Error : si la requête a échoué. La réponse contient une code et une message dans ce cas.

géocodage

S’applique à : consultez les niveaux de tarification .

Dans de nombreux cas, le service de recherche complet peut être trop important, par exemple si vous n’êtes intéressé que par le géocodage traditionnel. Vous pouvez également accéder à la recherche d’adresses exclusivement. Le géocodage est effectué en appuyant sur le point de terminaison de géocodage avec uniquement l’adresse ou l’adresse partielle en question. L’index de recherche de géocodage sera interrogé pour tous les éléments au-dessus des données au niveau de la rue. Aucun point d’intérêt (POI) n’est retourné. Notez que le géocodeur est très tolérant aux fautes de frappe et aux adresses incomplètes. Il gérera également tout à partir d’adresses de rue exactes ou de rues ou d’intersections ainsi que des zones géographiques de niveau supérieur telles que les centres urbains, les comtés, les états, etc.

Obtenir le polygone

S’applique à : consultez les niveaux de tarification .

Fournit des données polygones d’un plan géographique tel qu’une ville ou une région de pays.

Obtenir le polygone

S’applique à : consultez les niveaux de tarification .

Fournit des données polygones d’un plan géographique tel qu’une ville ou une région de pays.

géocodage inverse

S’applique à : consultez les niveaux de tarification .

Traduisez une coordonnée (exemple : 37.786505, -122.3862) en adresse postale compréhensible par l’homme. Le plus souvent, cela est nécessaire dans le suivi des applications où vous recevez un flux GPS de l’appareil ou de l’élément multimédia et souhaitez savoir quelle adresse se trouve la coordonnée. Ce point de terminaison retourne les informations d’adresse d’une coordonnée donnée.

api Batch de géocodage inverse

S’applique à: consultez les niveaux de tarification .

L’API Batch de géocodage inverse envoie des lots de requêtes à 'API de géocodage inverse à l’aide d’un seul appel d’API. L’API permet à l’appelant de traiter jusqu’à 100 requêtes.

Envoyer une demande de traitement par lots synchrone

L’API synchrone est recommandée pour les requêtes par lots légères. Lorsque le service reçoit une demande, il répond dès que les éléments de lot sont calculés et il n’y aura aucune possibilité de récupérer les résultats ultérieurement. L’API synchrone retourne une erreur de délai d’expiration (réponse 408) si la requête prend plus de 60 secondes. Le nombre d’éléments de lot est limité à 100 pour cette API.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

Corps POST pour la requête Batch

Pour envoyer le géocodage inverse requêtes, vous utiliserez une requête POST où le corps de la requête contiendra le tableau batchItems au format json et l’en-tête Content-Type sera défini sur application/json. Voici un exemple de corps de requête contenant 2 géocodage inverse requêtes :

{
  "batchItems": [
    {
      "coordinates": [-122.128275, 47.639429],
      "resultTypes": ["Address", "PopulatedPlace"]
    },
    {
      "coordinates": [-122.341979399674, 47.6095253501216]
    }
  ]
}

Un géocodage inverse objet batchItem peut accepter l’un des paramètres de géocodage inverse pris en charged’URI.

Le lot doit contenir au moins 1 requête.

Modèle de réponse par lot

La réponse par lot contient un composant summary qui indique les totalRequests qui faisaient partie de la demande de lot d’origine et successfulRequests c’est-à-dire les requêtes qui ont été exécutées avec succès. La réponse par lot inclut également un tableau batchItems qui contient une réponse pour chaque requête dans la requête de lot. Les batchItems contiennent les résultats dans le même ordre que les requêtes d’origine ont été envoyées dans la requête de lot. Chaque élément est de l’un des types suivants :

• GeocodingResponse : si la requête s’est terminée correctement.

• Error : si la requête a échoué. La réponse contient une code et une message dans ce cas.

api Batch de géocodage inverse

S’applique à: consultez les niveaux de tarification .

L’API Batch de géocodage inverse envoie des lots de requêtes à 'API de géocodage inverse à l’aide d’un seul appel d’API. L’API permet à l’appelant de traiter jusqu’à 100 requêtes.

Envoyer une demande de traitement par lots synchrone

L’API synchrone est recommandée pour les requêtes par lots légères. Lorsque le service reçoit une demande, il répond dès que les éléments de lot sont calculés et il n’y aura aucune possibilité de récupérer les résultats ultérieurement. L’API synchrone retourne une erreur de délai d’expiration (réponse 408) si la requête prend plus de 60 secondes. Le nombre d’éléments de lot est limité à 100 pour cette API.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

Corps POST pour la requête Batch

Pour envoyer le géocodage inverse requêtes, vous utiliserez une requête POST où le corps de la requête contiendra le tableau batchItems au format json et l’en-tête Content-Type sera défini sur application/json. Voici un exemple de corps de requête contenant 2 géocodage inverse requêtes :

{
  "batchItems": [
    {
      "coordinates": [-122.128275, 47.639429],
      "resultTypes": ["Address", "PopulatedPlace"]
    },
    {
      "coordinates": [-122.341979399674, 47.6095253501216]
    }
  ]
}

Un géocodage inverse objet batchItem peut accepter l’un des paramètres de géocodage inverse pris en charged’URI.

Le lot doit contenir au moins 1 requête.

Modèle de réponse par lot

La réponse par lot contient un composant summary qui indique les totalRequests qui faisaient partie de la demande de lot d’origine et successfulRequests c’est-à-dire les requêtes qui ont été exécutées avec succès. La réponse par lot inclut également un tableau batchItems qui contient une réponse pour chaque requête dans la requête de lot. Les batchItems contiennent les résultats dans le même ordre que les requêtes d’origine ont été envoyées dans la requête de lot. Chaque élément est de l’un des types suivants :

• GeocodingResponse : si la requête s’est terminée correctement.

• Error : si la requête a échoué. La réponse contient une code et une message dans ce cas.

géocodage inverse

S’applique à : consultez les niveaux de tarification .

Traduisez une coordonnée (exemple : 37.786505, -122.3862) en adresse postale compréhensible par l’homme. Le plus souvent, cela est nécessaire dans le suivi des applications où vous recevez un flux GPS de l’appareil ou de l’élément multimédia et souhaitez savoir quelle adresse se trouve la coordonnée. Ce point de terminaison retourne les informations d’adresse d’une coordonnée donnée.

Type d’objet GeoJSON Feature valide. Pour plus d’informations, reportez-vous à RFC 7946.

Objet geometry GeoJSON valide. Le type doit être l’un des sept types de géométrie GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, reportez-vous à RFC 7946.

Objet GeoJSON valide. Pour plus d’informations, reportez-vous à RFC 7946.

Crée une instance de MapsSearchClient à partir d’une clé d’abonnement.

exemple de

import MapsSearch from "@azure-rest/maps-search";
import { AzureKeyCredential } from "@azure/core-auth";

const credential = new AzureKeyCredential("<subscription-key>");
const client = MapsSearch(credential);

Crée une instance de MapsSearch à partir d’une TokenCredentiald’identité Azure.

exemple de

import MapsSearch from "@azure-rest/maps-search";
import { DefaultAzureCredential } from "@azure/identity";

const credential = new DefaultAzureCredential();
const client = MapsSearch(credential, "<maps-account-client-id>");

Crée une instance de MapsSearch à partir d’une AzureSASCredentiald’identité Azure.

exemple de

import MapsSearch from "@azure-rest/maps-search";
import { AzureSASCredential } from "@azure/core-auth";

const credential = new AzureSASCredential("<SAS Token>");
const client = MapsSearch(credential);