Maps Service

Maps

Esse serviço permite que scripts gerem mapas estáticos, encontrem rotas, convertam endereços em coordenadas de geocodificação e amostrem elevações.

Classes

NomeBreve descrição
AvoidUma enumeração que representa os tipos de restrições a serem evitadas 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 enums usados 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 encontrar direções, fazer geocodificação, amostragem de elevação e criar imagens estáticas de mapas.
MarkerSizeUma enumeração que representa o tamanho de um marcador adicionado a um mapa.
ModeUma enumeração que representa o modo de viagem a ser usado ao encontrar rotas.
StaticMapPermite a criação e a decoração de imagens de mapas estáticos.
StaticMapEnumsUma coleção de enums usados por StaticMap.
TypeUma enumeração que representa o tipo de mapa a ser renderizado.

Avoid

Propriedades

PropriedadeTipoDescrição
TOLLSEnumEvitar pedágios.
HIGHWAYSEnumEvitar 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 ponto de passagem pelo qual a rota precisa passar, usando um ponto (lat/lng).
addWaypoint(address)DirectionFinderAdiciona um ponto de referência que a rota precisa passar, usando um endereço.
clearWaypoints()DirectionFinderLimpa o conjunto atual de pontos de referência.
getDirections()ObjectRecebe as rotas usando a origem, o destino e outras opções definidas.
setAlternatives(useAlternatives)DirectionFinderDefine se rotas alternativas precisam ser retornadas em vez da rota com a classificação mais alta (o padrão é false).
setArrive(time)DirectionFinderDefine o horário de chegada desejado (quando aplicável).
setAvoid(avoid)DirectionFinderDefine se é necessário evitar determinados tipos de restrições.
setDepart(time)DirectionFinderDefine o horário de partida desejado (quando aplicável).
setDestination(latitude, longitude)DirectionFinderDefine o local de destino para o qual calcular rotas, usando um ponto (latitude/longitude).
setDestination(address)DirectionFinderDefine o local de destino para o qual calcular rotas usando um endereço.
setLanguage(language)DirectionFinderDefine o idioma que será usado nas rotas.
setMode(mode)DirectionFinderDefine o meio de transporte (o padrão é carro).
setOptimizeWaypoints(optimizeOrder)DirectionFinderDefine se o trajeto fornecido será otimizado reorganizando os waypoints em uma ordem mais eficiente (o padrão é false).
setOrigin(latitude, longitude)DirectionFinderDefine o local de partida para calcular rotas usando um ponto (latitude/longitude).
setOrigin(address)DirectionFinderDefine o local de partida para calcular rotas usando um endereço.
setRegion(region)DirectionFinderDefine uma região a ser usada ao interpretar nomes de 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 (latitude/longitude).
sampleLocations(points)ObjectRetorna dados de elevação para uma série de pontos (latitude/longitude).
sampleLocations(encodedPolyline)ObjectRetorna dados de elevação para os pontos em uma polilinha codificada.
samplePath(points, numSamples)ObjectRetorna dados de elevação para várias amostras ao longo de uma linha, definida usando uma série de pontos.
samplePath(encodedPolyline, numSamples)ObjectRetorna dados de elevação para várias amostras ao longo de uma linha, definida usando 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 de 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 deve ter preferência extra nos resultados.
setLanguage(language)GeocoderDefine o idioma a ser usado nos resultados.
setRegion(region)GeocoderDefine uma região a ser usada ao interpretar nomes de locais.

Maps

Propriedades

PropriedadeTipoDescrição
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Métodos

MétodoTipo de retornoBreve descrição
decodePolyline(polyline)Number[]Decodifica uma string de polilinha codificada em uma matriz de pontos.
encodePolyline(points)StringCodifica uma matriz de pontos em uma string.
newDirectionFinder()DirectionFinderCria um novo objeto DirectionFinder.
newElevationSampler()ElevationSamplerCria um objeto ElevationSampler.
newGeocoder()GeocoderCria um novo objeto Geocoder.
newStaticMap()StaticMapCria um objeto StaticMap.
resetAuthenticationApiKey()voidRedefine as credenciais de autenticação para usar as cotas padrão.
setAuthenticationByApiKey(apiKey)voidPermite o uso de uma chave de API para autenticar solicitações e aproveitar cotas adicionais.
setAuthenticationByApiKey(apiKey, signingKey)voidPermite o uso de uma chave de API e uma chave de assinatura para autenticar solicitações e aproveitar cotas adicionais no StaticMap.

MarkerSize

Propriedades

PropriedadeTipoDescrição
TINYEnumMercados pequenos (menores disponíveis).
MIDEnumMarcadores de tamanho médio (maiores disponíveis).
SMALLEnumMarcadores pequenos.

Mode

Propriedades

PropriedadeTipoDescrição
DRIVINGEnumRotas de carro por estradas.
WALKINGEnumRotas a pé por faixas de pedestre e calçadas (quando disponível).
BICYCLINGEnumRotas de bicicleta por ciclovias e ruas preferenciais (quando disponíveis).
TRANSITEnumRotas 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 (latitude/longitude).
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 (latitude/longitude) à definição de caminho atual.
addVisible(latitude, longitude)StaticMapAdiciona um local de ponto (lat/lng) que precisa 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()StaticMapLimpa o conjunto atual de caminhos.
clearVisibles()StaticMapLimpa o conjunto atual de locais visíveis.
endPath()StaticMapConclui uma definição de caminho iniciada com beginPath().
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 de marcador personalizada 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 o texto no mapa (quando disponível).
setMapType(mapType)StaticMapDefine o tipo de mapa a ser mostrado.
setMarkerStyle(size, color, label)StaticMapDefine o estilo do marcador a ser usado ao criar novos marcadores.
setMobile(useMobileTiles)StaticMapDefine se conjuntos de blocos especializados serão usados ou não 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 o nível de ampliação usado no mapa.

StaticMapEnums

Propriedades

PropriedadeTipoDescrição
ColorColor
FormatFormat
MarkerSizeMarkerSize
TypeType

Type

Propriedades

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