Le SDK Navigation n'est actuellement disponible que pour certains clients. Pour en savoir plus, contactez le service commercial.
De nouveaux styles de carte seront bientôt disponibles dans Google Maps Platform. Cette mise à jour du style de carte comprend une nouvelle palette de couleurs par défaut, ainsi que des améliorations apportées à l'expérience utilisateur et à la facilité d'utilisation des cartes. Tous les styles de carte seront automatiquement mis à jour en mars 2025. Pour en savoir plus sur la disponibilité et découvrir comment l'activer plus tôt, consultez Nouveau style de carte pour Google Maps Platform.
Afficher/Masquer le code Swift pour obtenir des informations sur l'itinéraire.
/*
* Copyright 2017 Google Inc. All rights reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import GoogleNavigation
import UIKit
class ViewController: UIViewController {
var mapView: GMSMapView!
var locationManager: CLLocationManager!
override func loadView() {
locationManager = CLLocationManager()
let camera = GMSCameraPosition.camera(withLatitude: 47.67, longitude: -122.20, zoom: 14)
mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
// Show the terms and conditions.
let companyName = "Ride Sharing Co."
GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
withCompanyName: companyName
) { termsAccepted in
guard termsAccepted else {
// Handle the case when the user rejects the terms and conditions.
return
}
// Enable navigation after the user accepts the terms.
self.mapView.isNavigationEnabled = true
// Request authorization to use location services.
self.locationManager.requestAlwaysAuthorization()
}
self.view = mapView
makeButtons()
}
// Create a route and start guidance.
func startNav() {
var destinations = [GMSNavigationWaypoint]()
destinations.append(
GMSNavigationWaypoint.init(
placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
title: "PCC Natural Market")!)
destinations.append(
GMSNavigationWaypoint.init(
placeID: "ChIJJ326ROcSkFQRBfUzOL2DSbo",
title: "Marina Park")!)
mapView.navigator?.setDestinations(destinations) { routeStatus in
guard routeStatus == .OK else {
print("Handle route statuses that are not OK.")
return
}
self.mapView.navigator?.isGuidanceActive = true
self.mapView.cameraMode = .following
self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
}
mapView.roadSnappedLocationProvider?.startUpdatingLocation()
}
func getTimeToNextDestination() {
if let navigator = mapView.navigator {
let time = navigator.timeToNextDestination
let minutes = floor(time / 60)
let seconds = round(time - minutes * 60)
print("Time to next destination: \(minutes):\(seconds)")
}
}
func getDistanceToNextDestination() {
if let navigator = mapView.navigator {
let distance = navigator.distanceToNextDestination
let miles = distance * 0.00062137
print("Distance to next destination: \(miles) miles.")
}
}
func getCurrentRouteLeg() {
if let navigator = mapView.navigator {
let currentLeg = navigator.currentRouteLeg
let nextDestination = currentLeg?.destinationWaypoint?.title ?? "Not Available"
let lat = currentLeg?.destinationCoordinate.latitude.description ?? "Not Available"
let lng = currentLeg?.destinationCoordinate.longitude.description ?? "Not Available"
print("Destination: \(nextDestination) at (\(lat),\(lng)")
}
}
func getTraveledPath() {
if let navigator = mapView.navigator {
let latestPath = navigator.traveledPath
if latestPath.count() > 0 {
let begin: CLLocationCoordinate2D = latestPath.coordinate(at: 0)
let current: CLLocationCoordinate2D = latestPath.coordinate(at: latestPath.count() - 1)
print(
"Path from (\(begin.latitude),\(begin.longitude)) to (\(current.latitude),\(current.longitude))"
)
}
}
}
// Add some buttons to the view.
func makeButtons() {
// Start navigation.
let navButton = UIButton(frame: CGRect(x: 5, y: 150, width: 200, height: 35))
navButton.backgroundColor = .blue
navButton.alpha = 0.5
navButton.setTitle("Start navigation", for: .normal)
navButton.addTarget(self, action: #selector(startNav), for: .touchUpInside)
self.mapView.addSubview(navButton)
// Get the time to the next destination.
let timeButton = UIButton(frame: CGRect(x: 5, y: 190, width: 200, height: 35))
timeButton.backgroundColor = .blue
timeButton.alpha = 0.5
timeButton.setTitle("Time to next destination", for: .normal)
timeButton.addTarget(self, action: #selector(getTimeToNextDestination), for: .touchUpInside)
self.mapView.addSubview(timeButton)
// Get the distance to the next destination.
let distanceButton = UIButton(frame: CGRect(x: 5, y: 230, width: 200, height: 35))
distanceButton.backgroundColor = .blue
distanceButton.alpha = 0.5
distanceButton.setTitle("Distance to next destination", for: .normal)
distanceButton.addTarget(
self, action: #selector(getDistanceToNextDestination), for: .touchUpInside)
self.mapView.addSubview(distanceButton)
// Get the current route leg.
let routeButton = UIButton(frame: CGRect(x: 5, y: 270, width: 200, height: 35))
routeButton.backgroundColor = .blue
routeButton.alpha = 0.5
routeButton.setTitle("Get current route leg", for: .normal)
routeButton.addTarget(self, action: #selector(getCurrentRouteLeg), for: .touchUpInside)
self.mapView.addSubview(routeButton)
// Get the most recently traveled path.
let pathButton = UIButton(frame: CGRect(x: 5, y: 310, width: 200, height: 35))
pathButton.backgroundColor = .blue
pathButton.alpha = 0.5
pathButton.setTitle("Get traveled path", for: .normal)
pathButton.addTarget(self, action: #selector(getTraveledPath), for: .touchUpInside)
self.mapView.addSubview(pathButton)
}
}
Afficher/Masquer le code Objective-C pour obtenir des informations sur l'itinéraire
/*
* Copyright 2017 Google Inc. All rights reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#import "ViewController.h"
@import GoogleNavigation;
@interface ViewController ()
@end
@implementation ViewController {
GMSMapView *_mapView;
CLLocationManager *_locationManager;
}
- (void)loadView {
_locationManager = [[CLLocationManager alloc] init];
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.67
longitude:-122.20
zoom:14];
_mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
// Show the terms and conditions.
NSString *companyName = @"Ride Sharing Co.";
[GMSNavigationServices
showTermsAndConditionsDialogIfNeededWithCompanyName:companyName
callback:^(BOOL termsAccepted) {
if (termsAccepted) {
// Enable navigation if the user accepts the terms.
_mapView.navigationEnabled = YES;
// Request authorization to use location services.
[_locationManager requestAlwaysAuthorization];
} else {
// Handle the case when the user rejects the terms and conditions.
}
}];
self.view = _mapView;
[self makeButtons];
}
// Create a route and start guidance.
- (void)startNav {
NSArray<GMSNavigationWaypoint *> *destinations =
@[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
title:@"PCC Natural Market"],
[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo"
title:@"Marina Park"]];
[_mapView.navigator setDestinations:destinations
callback:^(GMSRouteStatus routeStatus){
_mapView.navigator.guidanceActive = YES;
_mapView.cameraMode = GMSNavigationCameraModeFollowing;
[_mapView.locationSimulator simulateLocationsAlongExistingRoute];
}];
[_mapView.roadSnappedLocationProvider startUpdatingLocation];
}
- (void)getTimeToNextDestination {
NSTimeInterval time = _mapView.navigator.timeToNextDestination;
int minutes = floor(time/60);
int seconds = round(time - minutes * 60);
NSLog(@"%@", [NSString stringWithFormat:@"Time to next destination: %i:%i.", minutes, seconds]);
}
- (void)getDistanceToNextDestination {
CLLocationDistance distance = _mapView.navigator.distanceToNextDestination;
double miles = distance * 0.00062137;
NSLog(@"%@", [NSString stringWithFormat:@"Distance to next destination: %.2f.", miles]);
}
- (void)getCurrentRouteLeg {
GMSRouteLeg *currentSegment = _mapView.navigator.currentRouteLeg;
NSString *nextDestination = currentSegment.destinationWaypoint.title;
CLLocationDegrees lat = currentSegment.destinationCoordinate.latitude;
CLLocationDegrees lng = currentSegment.destinationCoordinate.longitude;
NSLog(@"%@", [NSString stringWithFormat:@"%@, %f/%f", nextDestination, lat, lng]);
}
- (void)getTraveledPath {
GMSPath *latestPath = _mapView.navigator.traveledPath;
if (latestPath.count > 0) {
CLLocationCoordinate2D begin = [latestPath coordinateAtIndex:0];
CLLocationCoordinate2D current = [latestPath coordinateAtIndex:latestPath.count - 1];
NSLog(@"Path from %f/%f to %f/%f",
begin.latitude,
begin.longitude,
current.latitude,
current.longitude);
}
}
#pragma mark - Buttons and things
// Add some buttons to the view.
- (void)makeButtons {
// Start navigation.
UIButton *navButton = [UIButton buttonWithType:UIButtonTypeCustom];
[navButton addTarget:self
action:@selector(startNav)
forControlEvents:UIControlEventTouchUpInside];
[navButton setTitle:@"Start navigation" forState:UIControlStateNormal];
[navButton setBackgroundColor:[UIColor blueColor]];
[navButton setAlpha:0.5];
navButton.frame = CGRectMake(5.0, 150.0, 200.0, 35.0);
[_mapView addSubview:navButton];
// Get the time to the next destination.
UIButton *timeButton = [UIButton buttonWithType:UIButtonTypeCustom];
[timeButton addTarget:self
action:@selector(getTimeToNextDestination)
forControlEvents:UIControlEventTouchUpInside];
[timeButton setTitle:@"Time to next destination" forState:UIControlStateNormal];
[timeButton setBackgroundColor:[UIColor blueColor]];
[timeButton setAlpha:0.5];
timeButton.frame = CGRectMake(5.0, 190.0, 200.0, 35.0);
[_mapView addSubview:timeButton];
// Get the distance to the next destination.
UIButton *distanceButton = [UIButton buttonWithType:UIButtonTypeCustom];
[distanceButton addTarget:self
action:@selector(getDistanceToNextDestination)
forControlEvents:UIControlEventTouchUpInside];
[distanceButton setTitle:@"Distance to next destination" forState:UIControlStateNormal];
[distanceButton setBackgroundColor:[UIColor blueColor]];
[distanceButton setAlpha:0.5];
distanceButton.frame = CGRectMake(5.0, 230.0, 200.0, 35.0);
[_mapView addSubview:distanceButton];
// Get the current route leg.
UIButton *routeButton = [UIButton buttonWithType:UIButtonTypeCustom];
[routeButton addTarget:self
action:@selector(getCurrentRouteLeg)
forControlEvents:UIControlEventTouchUpInside];
[routeButton setTitle:@"Get current route leg" forState:UIControlStateNormal];
[routeButton setBackgroundColor:[UIColor blueColor]];
[routeButton setAlpha:0.5];
routeButton.frame = CGRectMake(5.0, 270.0, 200.0, 35.0);
[_mapView addSubview:routeButton];
// Get the most recently traveled path.
UIButton *pathButton = [UIButton buttonWithType:UIButtonTypeCustom];
[pathButton addTarget:self
action:@selector(getTraveledPath)
forControlEvents:UIControlEventTouchUpInside];
[pathButton setTitle:@"Get current route leg" forState:UIControlStateNormal];
[pathButton setBackgroundColor:[UIColor blueColor]];
[pathButton setAlpha:0.5];
pathButton.frame = CGRectMake(5.0, 310.0, 200.0, 35.0);
[_mapView addSubview:pathButton];
}
@end
Obtenir le temps nécessaire pour atteindre la prochaine destination
Pour connaître l'heure de la prochaine destination, appelez timeToNextDestination().
Cela renvoie une valeur NSTimeInterval. L'exemple suivant montre
consigner l'heure à la destination suivante:
Swift
if let navigator = mapView.navigator {
let time = navigator.timeToNextDestination
let minutes = floor(time/60)
let seconds = round(time - minutes * 60)
NSLog("Time to next destination: %.0f:%.0f", minutes, seconds)
}
Objective-C
NSTimeInterval time = _mapView.navigator.timeToNextDestination;
int minutes = floor(time/60);
int seconds = round(time - minutes * 60);
NSLog(@"%@", [NSString stringWithFormat:@"Time to next destination: %i:%i.", minutes, seconds]);
Calcul de la distance jusqu'à la prochaine destination
Pour connaître la distance jusqu'à la prochaine destination, appelez distanceToNextDestination().
Cette opération renvoie une valeur CLLocationDistance. Les unités sont indiquées en mètres.
Swift
if let navigator = mapView.navigator {
let distance = navigator.distanceToNextDestination
let miles = distance * 0.00062137
NSLog("Distance to next destination: %.2f miles.", miles)
}
Objective-C
CLLocationDistance distance = _mapView.navigator.distanceToNextDestination;
double miles = distance * 0.00062137;
NSLog(@"%@", [NSString stringWithFormat:@"Distance to next destination: %.2f.", miles]);
Obtenir les conditions de circulation vers la destination suivante
Pour obtenir une valeur indiquant le flux de trafic vers la destination suivante, appelez
delayCategoryToNextDestination
Ce paramètre renvoie GMSNavigationDelayCategory. Les éléments suivants :
exemple illustre l'évaluation du résultat et la journalisation d'un message de trafic:
Swift
if let navigator = mapView.navigator {
// insert sample for evaluating traffic value
let delay = navigator.delayCategoryToNextDestination
let traffic = "unavailable"
switch delay {
case .noData:
traffic = "unavailable"
case .heavy:
traffic = "heavy"
case .medium:
traffic = "moderate"
case .light:
traffic = "light"
default:
traffic = "unavailable"
}
print("Traffic is \(traffic).")
}
Objective-C
GMSNavigationDelayCategory delay = mapView.navigator.delayCategoryToNextDestination;
NSString *traffic = @"";
switch (delayCategory) {
case GMSNavigationDelayCategoryNoData:
traffic = @"No Data";
break;
case GMSNavigationDelayCategoryHeavy:
traffic = @"Heavy";
break;
case GMSNavigationDelayCategoryMedium:
traffic = @"Medium";
break;
case GMSNavigationDelayCategoryLight:
traffic = @"Light";
break;
default:
NSLog(@"Invalid delay category: %zd", delayCategory);
}
NSLog(@"%@", [NSString stringWithFormat:@"Traffic is %@.", traffic]);
Obtenir des informations sur l'étape actuelle
Pour obtenir des informations sur l'étape actuelle de l'itinéraire, appelez currentRouteLeg.
Cela renvoie une instance GMSRouteLeg à partir de laquelle vous pouvez obtenir:
Destination de l'étape.
Coordonnée finale de l'étape.
Chemin contenant les coordonnées qui constituent la section de l'itinéraire.
L'exemple suivant illustre la journalisation du titre et des coordonnées de latitude/longitude pour le
section d'itinéraire suivante:
Swift
if let navigator = mapView.navigator {
let currentLeg = navigator.currentRouteLeg
let nextDestination = currentLeg?.destinationWaypoint?.title
let lat = currentLeg?.destinationCoordinate.latitude.description
let lng = currentLeg?.destinationCoordinate.longitude.description
NSLog(nextDestination! + ", " + lat! + "/" + lng!)
}
Pour obtenir le dernier chemin emprunté, appelez traveledPath.
Cela renvoie un GMSPath
qui a été simplifiée pour supprimer les points redondants (par exemple,
transformant des points colinaires consécutifs en un segment de ligne unique). Ce chemin est
vide jusqu'à ce que le guidage ait démarré. L'exemple suivant montre comment obtenir
chemin parcouru récemment:
Swift
if let navigator = mapView.navigator {
let latestPath = navigator.traveledPath
if latestPath.count() > 0 {
let begin: CLLocationCoordinate2D = latestPath.coordinate(at: 0)
let current: CLLocationCoordinate2D = latestPath.coordinate(at: latestPath.count() - 1)
print("Path from (\(begin.latitude),\(begin.longitude)) to (\(current.latitude),\(current.longitude))")
}
}
Objective-C
GMSPath *latestPath = mapView.navigator.traveledPath;
if (latestPath.count > 0) {
CLLocationCoordinate2D begin = [latestPath coordinateAtIndex:0];
CLLocationCoordinate2D current = [latestPath coordinateAtIndex:latestPath.count - 1];
NSLog(@"Path from %f/%f to %f/%f",
begin.latitude,
begin.longitude,
current.latitude,
current.longitude);
}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/03 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Il n'y a pas l'information dont j'ai besoin"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Trop compliqué/Trop d'étapes"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsolète"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Mauvais exemple/Erreur de code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]
{"lastModified": "Derni\u00e8re mise \u00e0 jour le 2024/08/03\u00a0(UTC)."}
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/08/03 (UTC)."]]