Class Maps

Mapy

Umożliwia wyznaczanie kierunku, geokodowanie, próbkowanie wysokości i tworzenie statycznych obrazów map.

Właściwości

WłaściwośćTypOpis
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Metody

MetodaZwracany typKrótki opis
decodePolyline(polyline)Number[]Dekoduje zakodowany ciąg znaków linii łamanej z powrotem do tablicy punktów.
encodePolyline(points)StringKoduje tablicę punktów w ciąg znaków.
newDirectionFinder()DirectionFinderTworzy nowy obiekt DirectionFinder.
newElevationSampler()ElevationSamplerTworzy obiekt ElevationSampler.
newGeocoder()GeocoderTworzy nowy obiekt Geocoder.
newStaticMap()StaticMapTworzy nowy obiekt StaticMap.
resetAuthenticationApiKey()voidResetuje dane uwierzytelniające, aby używać domyślnych limitów.
setAuthenticationByApiKey(apiKey)voidUmożliwia korzystanie z klucza interfejsu API do uwierzytelniania żądań w celu wykorzystania dodatkowych limitów.
setAuthenticationByApiKey(apiKey, signingKey)voidUmożliwia używanie klucza interfejsu API i klucza podpisywania do uwierzytelniania żądań w celu wykorzystania dodatkowych limitów w interfejsie StaticMap.

Szczegółowa dokumentacja

decodePolyline(polyline)

Dekoduje zakodowany ciąg znaków linii łamanej z powrotem do tablicy punktów. 

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

Parametry

NazwaTypOpis
polylineStringZakodowana linia łamana do zdekodowania.

Powrót

Number[] – tablica par szerokości i długości geograficznej (lat0, long0, lat1, long1, ...).

Zobacz też

encodePolyline(points)

Koduje tablicę punktów w ciąg znaków. 

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

Parametry

NazwaTypOpis
pointsNumber[]Tablica par szerokości i długości geograficznej do zakodowania.

Powrót

String – zakodowany ciąg znaków reprezentujący te punkty.

Zobacz też

newDirectionFinder()

Tworzy nowy obiekt DirectionFinder.

Powrót

DirectionFinder – nowy obiekt wyszukiwarki kierunku.

newElevationSampler()

Tworzy obiekt ElevationSampler.

Powrót

ElevationSampler – nowy obiekt próbnika wysokości.

newGeocoder()

Tworzy nowy obiekt Geocoder.

Powrót

Geocoder – nowy obiekt geokodera.

newStaticMap()

Tworzy nowy obiekt StaticMap.

Powrót

StaticMap – nowy obiekt mapy statycznej.

resetAuthenticationApiKey()

Resetuje dane uwierzytelniające, aby używać domyślnych limitów. Ta metoda działa, gdy do uwierzytelniania żądań używasz klucza interfejsu API. Tej metody można użyć, aby przywrócić domyślne limity, jeśli chcesz korzystać z metod Maps bez podawania danych uwierzytelniających. 

Maps.resetAuthenticationApiKey();

Rzuty

Error – jeśli do uwierzytelniania używana jest usługa setAuthentication(clientId, signingKey).

setAuthenticationByApiKey(apiKey)

Umożliwia korzystanie z klucza interfejsu API do uwierzytelniania żądań w celu wykorzystania dodatkowych limitów.

Ta metoda służy do ustawiania klucza interfejsu API, który jest używany do uwierzytelniania żądań. Gdy ta metoda jest wywoływana, wykorzystanie limitu i rozliczenia są naliczane w projekcie w chmurze Google Cloud powiązanym z podanym kluczem interfejsu API zgodnie z cennikiem. Możesz używać metod Maps z domyślnymi limitami bez podawania danych logowania. Jeśli używasz StaticMap, użyj metody setAuthenticationByApiKey(apiKey, signingKey). 

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parametry

NazwaTypOpis
apiKeyStringKlucz interfejsu API, który można uzyskać w konsoli Google Cloud, wykonując czynności opisane w przewodniku Szybki start.

Rzuty

Error – jeśli apiKey to null lub jeśli setAuthentication(clientId, signingKey) jest już używany do uwierzytelniania.

setAuthenticationByApiKey(apiKey, signingKey)

Umożliwia używanie klucza interfejsu API i klucza podpisywania do uwierzytelniania żądań w celu wykorzystania dodatkowych limitów w interfejsie StaticMap. Chociaż parametr signingKey jest wymagany w przypadku żądań do interfejsu Static Map API, tej metody można też używać do uwierzytelniania innych usług Map. W takich przypadkach parametr signingKey jest ignorowany.

Ta metoda służy do ustawiania klucza interfejsu API i klucza podpisywania, które są używane do uwierzytelniania żądań. Klucz podpisu jest wymagany w przypadku interfejsu StaticMap. W celach testowych akceptuje on niewielką liczbę żądań bez podpisu, ale gdy w środowisku produkcyjnym zostanie osiągnięty próg, żądania zaczną się nie powodzić. Więcej informacji znajdziesz tutaj. 

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

Parametry

NazwaTypOpis
apiKeyStringKlucz interfejsu API, który można uzyskać w konsoli Google Cloud, wykonując czynności opisane w przewodniku Szybki start.
signingKeyStringKlucz podpisywania, który można uzyskać w konsoli Google Cloud, wykonując czynności opisane w przewodniku po podpisie cyfrowym. Jest to wymagane w przypadku StaticMap i ignorowane w przypadku innych usług Map.

Rzuty

Error – jeśli apiKey to null lub jeśli setAuthentication(clientId, signingKey) jest już używany do uwierzytelniania.

Zobacz też

Wycofane metody