Cette page a été traduite par l'API Cloud Translation.

Calculer le résumé du routage

Pour utiliser Text Search (New) (Recherche textuelle (nouvelle version)) ou Nearby Search (New) (Recherche à proximité (nouvelle version)) pour calculer la durée et la distance de trajet vers chaque lieu de la réponse:

Transmettez le paramètre routingParameters.origin dans la requête pour spécifier les coordonnées de latitude et de longitude de l'origine du calcul d'itinéraire. Ce paramètre est obligatoire pour calculer la durée et la distance de chaque lieu dans la réponse.
Incluez routingSummaries dans le masque de champ afin que la réponse inclue le tableau routingSummaries. Ce tableau contient la durée et la distance entre le point de départ du calcul d'itinéraire et chaque lieu de la réponse.

Remarque:L'ajout de routingSummaries dans le masque de champ sans inclure le paramètre routingParameters.origin ou le paramètre searchAlongRouteParameters.polyline.encodedPolyline dans la requête entraîne une erreur.

API Explorer vous permet d'envoyer des requêtes en direct afin de vous familiariser avec l'API et ses options:

Essayer

Utiliser Text Search (nouvelle version)

Dans la requête suivante, vous calculez la durée du trajet et la distance à chaque lieu dans la réponse Text Search (New) :

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

La réponse contient deux tableaux JSON: le tableau places contient les lieux correspondants, et le tableau routingSummaries contient la durée et la distance à parcourir pour chaque lieu:

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

Chaque élément du tableau routingSummaries se trouve à l'emplacement de tableau correspondant à l'emplacement du tableau places. Autrement dit, l'élément situé à routingSummaries[0] correspond à l'emplacement situé à places[0].

La longueur du tableau routingSummaries est identique à celle du tableau places. Si l'routingSummary d'un lieu n'est pas disponible, l'entrée du tableau est vide.

Étant donné que cet exemple calcule la durée et la distance entre le point de départ du calcul d'itinéraire et chaque lieu, le champ routingSummaries.legs de la réponse ne contient qu'un seul objet Leg contenant les duration et distanceMeters entre le point de départ du calcul d'itinéraire et le lieu.

Remarque : Cette réponse inclut également le champ directionsUri "Preview (pre-GA)" (Aperçu (version préliminaire)) dans le récapitulatif de calcul d'itinéraire pour chaque lieu. Ce champ contient un lien permettant d'ouvrir un itinéraire vers le lieu dans Google Maps. Le paramètre routingParameters.origin est utilisé comme origine des itinéraires, l'emplacement du lieu est utilisé comme destination, et le mode de transport par défaut est "en voiture".

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

Dans cet exemple, vous pouvez voir que la durée et la distance entre l'origine du routage et le premier lieu dans les résultats sont de 597 secondes et de 2 607 mètres.

Utiliser Nearby Search

Dans cet exemple, vous calculez la durée du trajet et la distance à chaque lieu dans la réponse de la recherche à proximité. Cet exemple recherche des restaurants à Sydney, en Australie, et définit la restriction de zone géographique et l'origine du calcul d'itinéraire sur les mêmes coordonnées de latitude et de longitude:

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

Vous n'avez pas besoin d'utiliser les mêmes coordonnées pour locationRestriction et pour l'origine du calcul d'itinéraire. Par exemple, vous définissez locationRestriction sur le point central de Sydney pour biaiser les résultats de recherche vers ce cercle. Vous définissez ensuite l'origine du calcul d'itinéraire sur les coordonnées de votre maison, c'est-à-dire sur un autre emplacement dans le cercle de recherche. La requête biaise ensuite les résultats de recherche en fonction du cercle et calcule les récapitulatifs d'itinéraire en fonction de l'emplacement de votre maison.

Spécifier les options de trajet

Par défaut, les calculs de durée et de distance sont effectués pour une voiture. Toutefois, vous pouvez contrôler le type de véhicule, ainsi que d'autres options, dans la recherche.

Utilisez le paramètre routingParameters.travelMode pour définir le mode de transport sur DRIVE, BICYCLE, WALK ou TWO_WHEELER. Pour en savoir plus sur ces options, consultez la section Types de véhicules disponibles pour les itinéraires.

Remarque:L'API Routes prend également en charge un mode TRANSIT, mais ce mode n'est pas compatible avec l'API Places.

Remarque:L'option TWO_WHEELER n'est acceptée que dans les pays listés dans la section Pays et régions compatibles pour les véhicules à deux roues.
Utilisez la propriété routingParameters.routingPreference pour définir l'option de préférence de routage sur TRAFFIC_UNAWARE (par défaut), TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL. Chaque option présente des niveaux de qualité et de latence des données différents. Pour en savoir plus, consultez Spécifier comment et si inclure des données sur le trafic.
La propriété routingParameters.routingPreference affecte les itinéraires contenus dans le champ directionsUri Preview (Preview) (Aperçu (pré-DG)). En effet, Google Maps affiche des options de trafic lorsqu'il ouvre le lien.
Utilisez la propriété routingParameters.routeModifiers pour spécifier avoidTolls, avoidHighways, avoidFerries et avoidIndoor. Pour en savoir plus sur ces options, consultez la section Spécifier des éléments de parcours à éviter.

Dans l'exemple suivant, vous spécifiez le mode de déplacement comme DRIVE et évitez les autoroutes:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

Rechercher sur le trajet

Combiner le résumé du calcul d'itinéraire avec la recherche sur le trajet