Permet de créer et de décorer des images de cartes statiques.
L'exemple ci-dessous montre comment utiliser cette classe pour créer une carte du quartier des théâtres de New York, y compris les gares à proximité, et l'afficher dans une application Web simple.
// Create a map centered on Times Square. const map = Maps.newStaticMap().setSize(600, 600).setCenter( 'Times Square, New York, NY'); // Add markers for the nearbye train stations. map.setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T', ); map.addMarker('Grand Central Station, New York, NY'); map.addMarker('Penn Station, New York, NY'); // Show the boundaries of the Theatre District. const corners = [ '8th Ave & 53rd St, New York, NY', '6th Ave & 53rd St, New York, NY', '6th Ave & 40th St, New York, NY', '8th Ave & 40th St, New York, NY', ]; map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE); map.beginPath(); for (let i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;
Voir aussi
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
add | Static | Ajoute une adresse à la définition du chemin actuel. |
add | Static | Ajoute un repère à la carte à l'aide d'un point (lat/lng). |
add | Static | Ajoute un repère à la carte à l'aide d'une adresse. |
add | Static | Ajoute un chemin à la carte à l'aide d'un tableau de points. |
add | Static | Ajoute un chemin à la carte à l'aide d'une polyligne encodée. |
add | Static | Ajoute un point (lat/lng) à la définition du chemin actuel. |
add | Static | Ajoute un point (lat/lng) qui doit être visible sur la carte. |
add | Static | Ajoute une adresse qui doit être visible sur la carte. |
begin | Static | Démarre une nouvelle définition de chemin. |
clear | Static | Efface l'ensemble actuel de repères. |
clear | Static | Efface l'ensemble actuel de chemins. |
clear | Static | Efface l'ensemble actuel des lieux visibles. |
end | Static | Termine une définition de chemin commencée avec beginPath(). |
get | Blob | Renvoie les données de cet objet sous forme de blob converti au type de contenu spécifié. |
get | Blob | Récupère les données d'image sous la forme d'un Blob. |
get | Byte[] | Récupère les données d'image brutes sous forme de tableau d'octets. |
get | String | Récupère l'URL de l'image de la carte. |
set | Static | Définit le centre de la carte à l'aide d'un point (latitude/longitude). |
set | Static | Définit le centre de la carte à l'aide d'une adresse. |
set | Static | Définit l'image de repère personnalisée à utiliser lors de la création de repères. |
set | Static | Définit le format de l'image de la carte. |
set | Static | Définit la langue à utiliser pour le texte sur la carte (le cas échéant). |
set | Static | Définit le type de carte à afficher. |
set | Static | Définit le style de repère à utiliser lors de la création de repères. |
set | Static | Indique si des ensembles de tuiles spécialisés doivent être utilisés pour les appareils mobiles. |
set | Static | Définit le style de chemin à utiliser lors de la création de chemins. |
set | Static | Définit la largeur et la hauteur de l'image de la carte en pixels. |
set | Static | Définit le facteur de zoom ou le niveau d'agrandissement utilisé pour la carte. |
Documentation détaillée
add Address(address)
Ajoute une adresse à la définition du chemin actuel.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Paramètres
| Nom | Type | Description |
|---|---|---|
address | String | Adresse à ajouter. |
Renvois
Static : cette instance de carte, pour le chaînage.
add Marker(latitude, longitude)
Ajoute un repère à la carte à l'aide d'un point (lat/lng).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
Paramètres
| Nom | Type | Description |
|---|---|---|
latitude | Number | Latitude du nouveau repère. |
longitude | Number | Longitude du nouveau repère. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
add Marker(address)
Ajoute un repère à la carte à l'aide d'une adresse.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Paramètres
| Nom | Type | Description |
|---|---|---|
address | String | Adresse à laquelle placer le nouveau repère. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
add Path(points)
Ajoute un chemin à la carte à l'aide d'un tableau de points.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap().addPath([ 40.714353, -74.005973, 42.358431, -71.059773, ]);
Paramètres
| Nom | Type | Description |
|---|---|---|
points | Number[] | Tableau de paires latitude/longitude définissant le chemin. |
Renvois
Static : cette instance de carte, pour le chaînage.
add Path(polyline)
Ajoute un chemin à la carte à l'aide d'une polyligne encodée.
// Creates a map and adds a path from New York to Boston. const polyline = Maps.encodePolyline([ 40.714353, -74.005973, 42.358431, -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);
Paramètres
| Nom | Type | Description |
|---|---|---|
polyline | String | Polyligne encodée. |
Renvois
Static : cette instance de carte, pour le chaînage.
add Point(latitude, longitude)
Ajoute un point (lat/lng) à la définition du chemin actuel.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addPoint(40.714353, -74.005973) .addPoint(42.358431, -71.059773) .endPath();
Paramètres
| Nom | Type | Description |
|---|---|---|
latitude | Number | Latitude du point. |
longitude | Number | Longitude du point. |
Renvois
Static : cette instance de carte, pour le chaînage.
add Visible(latitude, longitude)
Ajoute un point (lat/lng) qui doit être visible sur la carte.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
Paramètres
| Nom | Type | Description |
|---|---|---|
latitude | Number | Latitude du point. |
longitude | Number | Longitude du point. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
add Visible(address)
Ajoute une adresse qui doit être visible sur la carte.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
Paramètres
| Nom | Type | Description |
|---|---|---|
address | String | Adresse qui doit être visible sur la carte. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
begin Path()
Démarre une nouvelle définition de chemin. Les appels à add et add définissent chaque nouveau sommet du chemin. Le chemin est terminé lorsque end est appelé.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Renvois
Static : cette instance de carte, pour le chaînage.
clear Markers()
Efface l'ensemble actuel de repères.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Renvois
Static : cette instance de carte, pour le chaînage.
clear Paths()
Efface l'ensemble actuel de chemins.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Renvois
Static : cette instance de carte, pour le chaînage.
clear Visibles()
Efface l'ensemble actuel des lieux visibles.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Renvois
Static : cette instance de carte, pour le chaînage.
end Path()
Termine une définition de chemin commencée avec beginPath().
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Renvois
Static : cette instance de carte, pour le chaînage.
get As(contentType)
Renvoie les données de cet objet sous forme de blob converti au type de contenu spécifié. Cette méthode ajoute l'extension appropriée au nom de fichier (par exemple, "myfile.pdf"). Toutefois, il suppose que la partie du nom de fichier qui suit le dernier point (le cas échéant) est une extension existante qui doit être remplacée. Par conséquent, "ShoppingList.12.25.2014" devient "ShoppingList.12.25.pdf".
Pour consulter les quotas quotidiens pour les conversions, consultez Quotas pour les services Google. Les domaines Google Workspace nouvellement créés peuvent être temporairement soumis à des quotas plus stricts.
Paramètres
| Nom | Type | Description |
|---|---|---|
content | String | Type MIME vers lequel effectuer la conversion. Pour la plupart des blobs, 'application/pdf' est la seule option valide. Pour les images au format BMP, GIF, JPEG ou PNG, les extensions 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' sont également valides. Pour un document Google Docs, 'text/markdown' est également valide. |
Renvois
Blob : données sous forme de blob.
get Blob()
Récupère les données d'image sous la forme d'un Blob.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
Renvois
Blob : image de la carte au format sélectionné.
get Map Image()
Récupère les données d'image brutes sous forme de tableau d'octets.
En général, préférez utiliser get, qui permet des interactions plus simples avec d'autres services.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile( Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'), );
Renvois
Byte[] : image de la carte au format sélectionné.
get Map Url()
Récupère l'URL de l'image de la carte.
// Creates a map centered on Times Square and gets the URL. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); // All static map URLs require an API key. Logger.log(`${map.getMapUrl()}&key=YOUR_API_KEY`);
Renvois
String : URL de l'image de la carte.
set Center(latitude, longitude)
Définit le centre de la carte à l'aide d'un point (latitude/longitude).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Paramètres
| Nom | Type | Description |
|---|---|---|
latitude | Number | Latitude du centre. |
longitude | Number | Longitude du centre. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Center(address)
Définit le centre de la carte à l'aide d'une adresse.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Paramètres
| Nom | Type | Description |
|---|---|---|
address | String | Adresse du centre. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Custom Marker Style(imageUrl, useShadow)
Définit l'image de repère personnalisée à utiliser lors de la création de repères. Les repères déjà ajoutés ne sont pas concernés.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setCustomMarkerStyle( 'http://www.example.com/marker.png', false, );
Paramètres
| Nom | Type | Description |
|---|---|---|
image | String | Spécifie une URL à utiliser comme icône personnalisée du repère. Les images peuvent être au format PNG, JPEG ou GIF, mais le format PNG est recommandé. |
use | Boolean | Indique que le repère doit avoir une ombre générée, en fonction de la région visible de l'image et de son opacité/transparence. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Format(format)
Définit le format de l'image de la carte.
// Creates a map with the image format set to PNG. const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);
Paramètres
| Nom | Type | Description |
|---|---|---|
format | String | Valeur constante de Format. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Language(language)
Définit la langue à utiliser pour le texte sur la carte (le cas échéant).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Paramètres
| Nom | Type | Description |
|---|---|---|
language | String | Identifiant de langue BCP-47. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Map Type(mapType)
set Marker Style(size, color, label)
Définit le style de repère à utiliser lors de la création de repères. Les repères déjà ajoutés ne sont pas concernés.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK, '1', );
Paramètres
| Nom | Type | Description |
|---|---|---|
size | String | Valeur constante de Marker. |
color | String | Chaîne au format "0xrrggbb" ou valeur constante de Color. |
label | String | Chaîne contenant un seul caractère (A-Z ou 0-9). |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Mobile(useMobileTiles)
Indique si des ensembles de tuiles spécialisés doivent être utilisés pour les appareils mobiles.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
Paramètres
| Nom | Type | Description |
|---|---|---|
use | Boolean | Indique s'il faut utiliser ou non les cartes mobiles. |
Renvois
Static : cette instance de carte, pour le chaînage.
set Path Style(weight, color, fillColor)
Définit le style de chemin à utiliser lors de la création de chemins. Les chemins d'accès déjà ajoutés ne sont pas affectés.
// Creates a map with paths set to be 1 pixel wide with a black line and a white // fill. const map = Maps.newStaticMap().setPathStyle( 1, Maps.StaticMap.Color.BLACK, 'red', );
Paramètres
| Nom | Type | Description |
|---|---|---|
weight | Integer | Largeur des lignes en pixels. |
color | String | Couleur de la ligne, sous forme de chaîne au format "0xrrggbb" ou de valeur constante de Color. |
fill | String | Couleur de remplissage, chaîne au format "0xrrggbb" ou valeur constante de Color. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Size(width, height)
Définit la largeur et la hauteur de l'image de la carte en pixels.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
Paramètres
| Nom | Type | Description |
|---|---|---|
width | Integer | Largeur de l'image en pixels. |
height | Integer | Hauteur de l'image en pixels. |
Renvois
Static : cette instance de carte, pour le chaînage.
Voir aussi
set Zoom(zoom)
Définit le facteur de zoom ou le niveau d'agrandissement utilisé pour la carte.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
Paramètres
| Nom | Type | Description |
|---|---|---|
zoom | Integer | Valeur comprise entre 0 et 21, inclus. |
Renvois
Static : cette instance de carte, pour le chaînage.