Class Maps

Maps

Ermöglicht die Routenplanung, Geocodierung, Höhenmessung und die Erstellung statischer Kartenbilder.

Properties

AttributTypBeschreibung
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Methoden

MethodeRückgabetypKurzbeschreibung
decodePolyline(polyline)Number[]Decodiert einen codierten Polylinienstring wieder in ein Array von Punkten.
encodePolyline(points)StringCodiert ein Array von Punkten in einen String.
newDirectionFinder()DirectionFinderErstellt ein neues DirectionFinder-Objekt.
newElevationSampler()ElevationSamplerErstellt ein ElevationSampler-Objekt.
newGeocoder()GeocoderErstellt ein neues Geocoder-Objekt.
newStaticMap()StaticMapErstellt ein neues StaticMap-Objekt.
resetAuthenticationApiKey()voidSetzt die Authentifizierungsdaten zurück, um die Standardkontingente zu verwenden.
setAuthenticationByApiKey(apiKey)voidErmöglicht die Verwendung eines API-Schlüssels zur Authentifizierung von Anfragen, um zusätzliche Kontingente zu nutzen.
setAuthenticationByApiKey(apiKey, signingKey)voidErmöglicht die Verwendung eines API-Schlüssels und eines Signaturschlüssels zur Authentifizierung von Anfragen, um zusätzliche Kontingente in StaticMap zu nutzen.

Detaillierte Dokumentation

decodePolyline(polyline)

Decodiert einen codierten Polylinienstring wieder in ein Array von Punkten.

// 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]);
}

Parameter

NameTypBeschreibung
polylineStringEine zu decodierende codierte Polylinie.

Rückflug

Number[] — Ein Array von Breiten- und Längengradpaaren (lat0, long0, lat1, long1, ...).

Weitere Informationen


encodePolyline(points)

Codiert ein Array von Punkten in einen String.

// 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);

Parameter

NameTypBeschreibung
pointsNumber[]Ein Array von Breiten-/Längengradpaaren, die codiert werden sollen.

Rückflug

String — Ein codierter String, der diese Punkte darstellt.

Weitere Informationen


newDirectionFinder()

Erstellt ein neues DirectionFinder-Objekt.

Rückflug

DirectionFinder — Ein neues DirectionFinder-Objekt.


newElevationSampler()

Erstellt ein ElevationSampler-Objekt.

Rückflug

ElevationSampler — Ein neues ElevationSampler-Objekt.


newGeocoder()

Erstellt ein neues Geocoder-Objekt.

Rückflug

Geocoder — Ein neues Geocoder-Objekt.


newStaticMap()

Erstellt ein neues StaticMap-Objekt.

Rückflug

StaticMap — Ein neues StaticMap-Objekt.


resetAuthenticationApiKey()

Setzt die Authentifizierungsdaten zurück, um die Standardkontingente zu verwenden. Diese Methode funktioniert, wenn Sie einen API-Schlüssel zur Authentifizierung von Anfragen verwenden. Mit dieser Methode können Sie zu den Standardkontingenten zurückkehren, wenn Sie die Maps-Methoden verwenden möchten, ohne Authentifizierungsdaten anzugeben.

Maps.resetAuthenticationApiKey();

Löst

Error — wenn setAuthentication(clientId, signingKey) zur Authentifizierung verwendet wird.


setAuthenticationByApiKey(apiKey)

Ermöglicht die Verwendung eines API-Schlüssels zur Authentifizierung von Anfragen, um zusätzliche Kontingente zu nutzen.

Mit dieser Methode wird ein API-Schlüssel festgelegt, der zur Authentifizierung von Anfragen verwendet wird. Wenn diese Methode aufgerufen wird, werden der Kontingentverbrauch und die Abrechnung gemäß der Preisliste dem Google Cloud-Projekt in Rechnung gestellt, das mit dem angegebenen API-Schlüssel verknüpft ist. Sie können die Maps-Methoden mit den Standardkontingenten verwenden, ohne Authentifizierungsdaten anzugeben. Wenn Sie StaticMap verwenden, verwenden Sie stattdessen die Methode setAuthenticationByApiKey(apiKey, signingKey).

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parameter

NameTypBeschreibung
apiKeyStringEin API-Schlüssel, den Sie in der Google Cloud Console abrufen können. Folgen Sie dazu der Anleitung in der Kurzanleitung.

Löst

Error — wenn apiKey null ist oder wenn setAuthentication(clientId, signingKey) bereits zur Authentifizierung verwendet wird.


setAuthenticationByApiKey(apiKey, signingKey)

Ermöglicht die Verwendung eines API-Schlüssels und eines Signaturschlüssels zur Authentifizierung von Anfragen, um zusätzliche Kontingente in StaticMap zu nutzen. Der signingKey ist für Anfragen an die Static Map API erforderlich. Diese Methode kann aber auch zur Authentifizierung anderer Maps-Dienste verwendet werden. In diesen Fällen wird der Parameter signingKey ignoriert.

Mit dieser Methode wird ein API-Schlüssel und ein Signaturschlüssel festgelegt, der zur Authentifizierung von Anfragen verwendet wird. Der Signaturschlüssel ist für StaticMap erforderlich. Für Testzwecke werden eine kleine Anzahl von Anfragen ohne Signatur akzeptiert. Diese schlagen jedoch fehl, sobald der Schwellenwert in Ihrer Produktionsumgebung erreicht wird. Weitere Informationen finden Sie hier.

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

Parameter

NameTypBeschreibung
apiKeyStringEin API-Schlüssel, den Sie in der Google Cloud Console abrufen können. Folgen Sie dazu der Anleitung in der Kurzanleitung.
signingKeyStringEin Signaturschlüssel, den Sie in der Google Cloud Console abrufen können. Folgen Sie dazu der Anleitung für digitale Signaturen. Dieser ist für StaticMap erforderlich und wird für andere Maps Dienste ignoriert.

Löst

Error — wenn apiKey null ist oder wenn setAuthentication(clientId, signingKey) bereits zur Authentifizierung verwendet wird.

Weitere Informationen

Veraltete Methoden