Maps Service

Maps

Esse serviço permite que os scripts gerem mapas estáticos, encontrem rotas, convertam endereços em coordenadas de geocódigo e elevação de amostras.

Classes

NomeBreve descrição
AvoidUma enumeração que representa os tipos de restrições a serem evitados ao encontrar rotas.
ColorUma enumeração que representa as cores nomeadas disponíveis para uso em imagens de mapa.
DirectionFinderPermite a recuperação de rotas entre locais.
DirectionFinderEnumsUma coleção de enumerações usadas por DirectionFinder.
ElevationSamplerPermite a amostragem de elevações em locais específicos.
FormatUma enumeração que representa o formato da imagem do mapa.
GeocoderPermite a conversão entre um endereço e coordenadas geográficas.
MapsPermite a localização de rotas, geocodificação, amostragem de elevação e criação de imagens de mapa estáticas.
MarkerSizeUma enumeração que representa o tamanho de um marcador adicionado a um mapa.
ModeUma enumeração que representa o meio de transporte a ser usado ao encontrar rotas.
StaticMapPermite criar e decorar imagens estáticas do mapa.
StaticMapEnumsUma coleção de enumerações usadas por StaticMap.
TypeUma enumeração que representa o tipo de mapa a ser renderizado.

Avoid

Propriedades

PropriedadeTipoDescrição
TOLLSEnumEvitar pedágios.
HIGHWAYSEnumEvite rodovias.

Color

Propriedades

PropriedadeTipoDescrição
BLACKEnum
BROWNEnum
GREENEnum
PURPLEEnum
YELLOWEnum
BLUEEnum
GRAYEnum
ORANGEEnum
REDEnum
WHITEEnum

DirectionFinder

Métodos

MétodoTipo de retornoBreve descrição
addWaypoint(latitude, longitude)DirectionFinderAdiciona um waypoint em que o trajeto precisa passar, usando um ponto (lat/lng).
addWaypoint(address)DirectionFinderAdiciona um waypoint que o trajeto precisa atravessar, usando um endereço.
clearWaypoints()DirectionFinderLimpa o conjunto atual de waypoints.
getDirections()ObjectRecebe as rotas usando a origem, o destino e outras opções que foram definidas.
setAlternatives(useAlternatives)DirectionFinderDefine se rotas alternativas precisam ou não ser retornadas, em vez de apenas a rota mais alta classificada (o padrão é "false").
setArrive(time)DirectionFinderDefine o horário de chegada desejado (quando aplicável).
setAvoid(avoid)DirectionFinderDefine se é necessário evitar certos tipos de restrições.
setDepart(time)DirectionFinderDefine o horário de partida desejado (quando aplicável).
setDestination(latitude, longitude)DirectionFinderDefine o local final para o qual a rota será calculada, usando um ponto (lat/lng).
setDestination(address)DirectionFinderDefine o local final para o qual a rota será calculada, usando um endereço.
setLanguage(language)DirectionFinderDefine o idioma a ser usado nas rotas.
setMode(mode)DirectionFinderDefine o modo de viagem (o padrão é dirigir).
setOptimizeWaypoints(optimizeOrder)DirectionFinderDefine se é necessário otimizar o trajeto fornecido reorganizando os waypoints em uma ordem mais eficiente (o padrão é falso).
setOrigin(latitude, longitude)DirectionFinderDefine o ponto de partida de onde as rotas serão calculadas, usando um ponto (lat/lng).
setOrigin(address)DirectionFinderDefine o local de partida para calcular as rotas, usando um endereço.
setRegion(region)DirectionFinderDefine uma região a ser usada ao interpretar os nomes dos locais.

DirectionFinderEnums

Propriedades

PropriedadeTipoDescrição
AvoidAvoid
ModeMode

ElevationSampler

Métodos

MétodoTipo de retornoBreve descrição
sampleLocation(latitude, longitude)ObjectRetorna dados de elevação para um único ponto (lat/lng).
sampleLocations(points)ObjectRetorna dados de elevação para uma série de pontos (lat/lng).
sampleLocations(encodedPolyline)ObjectRetorna dados de elevação para os pontos em uma polilinha codificada.
samplePath(points, numSamples)ObjectRetorna dados de elevação para vários exemplos ao longo de uma linha, definidos com base em uma série de pontos.
samplePath(encodedPolyline, numSamples)ObjectRetorna dados de elevação para vários exemplos ao longo de uma linha, definidos com uma polilinha codificada.

Format

Propriedades

PropriedadeTipoDescrição
PNGEnumFormato PNG de 8 bits.
PNG8EnumFormato PNG de 8 bits.
PNG32EnumFormato PNG de 32 bits.
GIFEnumFormato GIF.
JPGEnumFormato JPEG.
JPG_BASELINEEnumFormato JPEG não progressivo.

Geocoder

Métodos

MétodoTipo de retornoBreve descrição
geocode(address)ObjectRecebe os pontos geográficos aproximados para um determinado endereço.
reverseGeocode(latitude, longitude)ObjectRecebe os endereços aproximados de um determinado ponto geográfico.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderDefine os limites de uma área que terá prioridade extra nos resultados.
setLanguage(language)GeocoderDefine o idioma a ser usado nos resultados.
setRegion(region)GeocoderDefine uma região a ser usada ao interpretar os nomes dos locais.

Maps

Propriedades

PropriedadeTipoDescrição
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Métodos

MétodoTipo de retornoBreve descrição
decodePolyline(polyline)Number[]Decodifica uma string de polilinha codificada novamente em uma matriz de pontos.
encodePolyline(points)StringCodifica uma matriz de pontos em uma string.
newDirectionFinder()DirectionFinderCria um novo objeto DirectionFinder.
newElevationSampler()ElevationSamplerCrie um objeto ElevationSampler.
newGeocoder()GeocoderCria um novo objeto do geocodificador.
newStaticMap()StaticMapCria um novo objeto StaticMap.
setAuthentication(clientId, signingKey)voidPermite o uso de uma conta do plano Premium das APIs Google Maps estabelecida externamente para aproveitar outras permissões de cota.

MarkerSize

Propriedades

PropriedadeTipoDescrição
TINYEnumMercados de pequeno porte (o menor disponível).
MIDEnumMarcadores de tamanho médio (maior tamanho disponível).
SMALLEnumMarcadores de tamanho pequeno.

Mode

Propriedades

PropriedadeTipoDescrição
DRIVINGEnumRotas de carro por vias.
WALKINGEnumRotas a pé por passarelas e calçadas (quando disponível).
BICYCLINGEnumRotas de bicicleta por ciclovias e ruas preferenciais (quando disponíveis).
TRANSITEnumRotas de transporte público por trajetos de transporte público (quando disponíveis).

StaticMap

Métodos

MétodoTipo de retornoBreve descrição
addAddress(address)StaticMapAdiciona um novo endereço à definição de caminho atual.
addMarker(latitude, longitude)StaticMapAdiciona um marcador ao mapa usando um ponto (lat/lng).
addMarker(address)StaticMapAdiciona um marcador ao mapa usando um endereço.
addPath(points)StaticMapAdiciona um caminho ao mapa usando uma matriz de pontos.
addPath(polyline)StaticMapAdiciona um caminho ao mapa usando uma polilinha codificada.
addPoint(latitude, longitude)StaticMapAdiciona um novo ponto (lat/lng) à definição de caminho atual.
addVisible(latitude, longitude)StaticMapAdiciona um local de ponto (lat/lng) que deve estar visível no mapa.
addVisible(address)StaticMapAdiciona um local de endereço que precisa estar visível no mapa.
beginPath()StaticMapInicia uma nova definição de caminho.
clearMarkers()StaticMapLimpa o conjunto atual de marcadores.
clearPaths()StaticMapLimpe o conjunto atual de caminhos.
clearVisibles()StaticMapLimpa o conjunto atual de locais visíveis.
endPath()StaticMapCompleta uma definição de caminho iniciada com startPath().
getAs(contentType)BlobRetorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRecebe os dados da imagem como um Blob.
getMapImage()Byte[]Recebe os dados brutos da imagem como uma matriz de bytes.
getMapUrl()StringRecebe o URL da imagem do mapa.
setCenter(latitude, longitude)StaticMapDefine o centro do mapa usando um ponto (lat/lng).
setCenter(address)StaticMapDefine o centro do mapa usando um endereço.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapDefine a imagem do marcador personalizado a ser usada ao criar novos marcadores.
setFormat(format)StaticMapDefine o formato da imagem do mapa.
setLanguage(language)StaticMapDefine o idioma a ser usado para texto no mapa (onde avaialbe).
setMapType(mapType)StaticMapDefine o tipo de mapa a ser exibido.
setMarkerStyle(size, color, label)StaticMapDefine o estilo do marcador a ser usado ao criar novos marcadores.
setMobile(useMobileTiles)StaticMapDefine se é necessário ou não usar conjuntos de blocos especializados para dispositivos móveis.
setPathStyle(weight, color, fillColor)StaticMapDefine o estilo de caminho a ser usado ao criar novos caminhos.
setSize(width, height)StaticMapDefine a largura e a altura da imagem do mapa em pixels.
setZoom(zoom)StaticMapDefine o fator de zoom, ou nível de ampliação, usado para o mapa.

StaticMapEnums

Propriedades

PropriedadeTipoDescrição
ColorColor
FormatFormat
MarkerSizeMarkerSize
TypeType

Type

Propriedades

PropriedadeTipoDescrição
ROADMAPEnumUm roteiro padrão, como normalmente é exibido no site do Google Maps.
SATELLITEEnumUm mapa de satélite.
TERRAINEnumUm mapa de relevo físico que mostra terreno e vegetação.
HYBRIDEnumUm híbrido dos mapas de satélite e de mapa, mostrando uma camada transparente das principais ruas e nomes de lugares no mapa de satélite.