Class Maps

Maps

Permet de trouver des itinéraires, de géocoder des adresses, d'échantillonner des altitudes et de créer des images de cartes statiques.

Propriétés

PropriétéTypeDescription
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Méthodes

MéthodeType renvoyéBrève description
decodePolyline(polyline)Number[]Décode une chaîne de polyligne encodée en un tableau de points.
encodePolyline(points)StringEncode un tableau de points en chaîne.
newDirectionFinder()DirectionFinderCrée un objet DirectionFinder.
newElevationSampler()ElevationSamplerCrée un objet ElevationSampler.
newGeocoder()GeocoderCrée un objet Geocoder.
newStaticMap()StaticMapCrée un objet StaticMap.
resetAuthenticationApiKey()voidRéinitialise les identifiants d'authentification pour utiliser les quotas par défaut.
setAuthenticationByApiKey(apiKey)voidPermet d'utiliser une clé API pour authentifier les requêtes et bénéficier de quotas supplémentaires.
setAuthenticationByApiKey(apiKey, signingKey)voidPermet d'utiliser une clé API et une clé de signature pour authentifier les requêtes et bénéficier de quotas supplémentaires dans StaticMap.

Documentation détaillée

decodePolyline(polyline)

Décode une chaîne de polyligne encodée en un tableau de points.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

Paramètres

NomTypeDescription
polylineStringPolyligne encodée à décoder.

Renvois

Number[] : tableau de paires latitude/longitude (lat0, long0, lat1, long1, ...).

Voir aussi


encodePolyline(points)

Encode un tableau de points en chaîne.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

Paramètres

NomTypeDescription
pointsNumber[]Tableau de paires latitude/longitude à encoder.

Renvois

String : chaîne encodée représentant ces points.

Voir aussi


newDirectionFinder()

Crée un objet DirectionFinder.

Renvois

DirectionFinder : nouvel objet de recherche de direction.


newElevationSampler()

Crée un objet ElevationSampler.

Renvois

ElevationSampler : nouvel objet d'échantillonneur d'altitude.


newGeocoder()

Crée un objet Geocoder.

Renvois

Geocoder : nouvel objet de géocodeur.


newStaticMap()

Crée un objet StaticMap.

Renvois

StaticMap : nouvel objet de carte statique.


resetAuthenticationApiKey()

Réinitialise les identifiants d'authentification pour utiliser les quotas par défaut. Cette méthode fonctionne lorsque vous utilisez une clé API pour authentifier les requêtes. Cette méthode peut être utilisée pour revenir aux quotas par défaut si vous souhaitez utiliser les méthodes Maps sans fournir d'identifiants d'authentification.

Maps.resetAuthenticationApiKey();

Génère

Error : si setAuthentication(clientId, signingKey) est utilisé pour l'authentification.


setAuthenticationByApiKey(apiKey)

Permet d'utiliser une clé API pour authentifier les requêtes et bénéficier de quotas supplémentaires.

Cette méthode permet de définir une clé API utilisée pour authentifier les requêtes. Lorsque cette méthode est appelée, la consommation de quota et la facturation sont imputées au projet Google Cloud associé à la clé API fournie, conformément à la grille tarifaire. Vous pouvez utiliser les méthodes Maps avec les quotas par défaut sans fournir d'identifiants d'authentification. Si vous utilisez StaticMap, veuillez utiliser la méthode setAuthenticationByApiKey(apiKey, signingKey) à la place.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Paramètres

NomTypeDescription
apiKeyStringUne clé API que vous pouvez obtenir dans la console Google Cloud en suivant les étapes décrites dans le guide de démarrage rapide.

Génère

Error : si apiKey est null ou si setAuthentication(clientId, signingKey) est déjà utilisé pour l'authentification


setAuthenticationByApiKey(apiKey, signingKey)

Permet d'utiliser une clé API et une clé de signature pour authentifier les requêtes et bénéficier de quotas supplémentaires dans StaticMap. Bien que la signingKey soit requise pour les requêtes envoyées à l'API Static Maps, cette méthode peut également être utilisée pour authentifier d'autres services Maps. Dans ce cas, le paramètre signingKey est ignoré.

Cette méthode permet de définir une clé API et une clé de signature utilisées pour authentifier les requêtes. Une clé de signature est requise pour StaticMap. Elle accepte un petit nombre de requêtes sans signature à des fins de test, mais elles commencent à échouer une fois le seuil atteint dans votre production. Pour en savoir plus, cliquez ici.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

Paramètres

NomTypeDescription
apiKeyStringUne clé API que vous pouvez obtenir dans la console Google Cloud en suivant les étapes décrites dans le guide de démarrage rapide.
signingKeyStringUne clé de signature que vous pouvez obtenir dans la console Google Cloud en suivant les étapes décrites dans le guide sur la signature numérique. Ce paramètre est obligatoire pour StaticMap et ignoré pour les autres services Maps.

Génère

Error : si apiKey est null ou si setAuthentication(clientId, signingKey) est déjà utilisé pour l'authentification

Voir aussi

Méthodes obsolètes