Clase DirectionsService
Clase google.maps.DirectionsService
Es un servicio para calcular instrucciones sobre cómo llegar entre dos o más lugares.
Llama al const {DirectionsService} = await google.maps.importLibrary("routes")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
DirectionsService |
DirectionsService() Parámetros: Ninguno
Crea una instancia nueva de un DirectionsService que envía consultas de direcciones a los servidores de Google. |
Métodos | |
---|---|
route |
route(request[, callback]) Parámetros:
Valor de devolución:
Promise<DirectionsResult> Envía una solicitud de búsqueda de instrucciones sobre cómo llegar. |
Interfaz de DirectionsRequest
Interfaz de google.maps.DirectionsRequest
Es una consulta de instrucciones sobre cómo llegar que se enviará a DirectionsService
.
Propiedades | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Ubicación de destino. Se puede especificar como una cadena para geocodificar, un LatLng o un Place . Obligatorio. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Ubicación de origen. Se puede especificar como una cadena para geocodificar, un LatLng o un Place . Obligatorio. |
travelMode |
Tipo:
TravelMode Es el tipo de ruta solicitada. Obligatorio. |
avoidFerries optional |
Tipo:
boolean optional Si es true , indica al servicio de Directions que evite los ferris siempre que sea posible. Opcional. |
avoidHighways optional |
Tipo:
boolean optional Si es true , indica al servicio de Directions que evite las autopistas siempre que sea posible. Opcional. |
avoidTolls optional |
Tipo:
boolean optional Si es true , indica al servicio de Directions que evite las rutas con peaje siempre que sea posible. Opcional. |
drivingOptions optional |
Tipo:
DrivingOptions optional Es la configuración que se aplica solo a las solicitudes en las que travelMode es DRIVING . Este objeto no tendrá ningún efecto en otros modos de viaje. |
language optional |
Tipo:
string optional Es un identificador del idioma en el que se deben mostrar los resultados, cuando sea posible. Consulta la lista de idiomas compatibles. |
optimizeWaypoints optional |
Tipo:
boolean optional Si se establece en true , el objeto DirectionsService intentará reordenar los puntos de ruta intermedios proporcionados para minimizar el costo general de la ruta. Si se optimizan los puntos de referencia, inspecciona DirectionsRoute.waypoint_order en la respuesta para determinar el nuevo orden. |
provideRouteAlternatives optional |
Tipo:
boolean optional Indica si se deben proporcionar rutas alternativas. Opcional. |
region optional |
Tipo:
string optional Es el código de región que se usa como sesgo para las solicitudes de codificación geográfica. El código de región acepta un valor de ccTLD ("dominio de nivel superior") de dos caracteres. La mayoría de los códigos ccTLD son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" ( .co.uk ), mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad de "El Reino Unido de Gran Bretaña e Irlanda del Norte"). |
transitOptions optional |
Tipo:
TransitOptions optional Es la configuración que se aplica solo a las solicitudes en las que travelMode es TRANSIT. Este objeto no tendrá ningún efecto en otros modos de viaje. |
unitSystem optional |
Tipo:
UnitSystem optional Valor predeterminado: Es el sistema de unidades que se usa en el país de origen.
Sistema de unidades preferido para mostrar la distancia. |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Es un array de puntos de referencia intermedios. Las instrucciones se calculan desde el origen hasta el destino a través de cada punto de referencia de este array. Consulta la guía para desarrolladores para conocer la cantidad máxima de puntos de referencia permitidos. No se admiten waypoints para indicaciones de transporte. Opcional. |
Constantes de DirectionsStatus
Constantes de google.maps.DirectionsStatus
Es el estado que muestra DirectionsService
cuando se completa una llamada a route()
. Puedes especificarlos por valor o con el nombre de la constante. Por ejemplo, 'OK'
o google.maps.DirectionsStatus.OK
.
Llama al const {DirectionsStatus} = await google.maps.importLibrary("routes")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
El DirectionsRequest proporcionado no es válido. |
MAX_WAYPOINTS_EXCEEDED |
Se proporcionaron demasiados DirectionsWaypoint en el DirectionsRequest . Consulta la guía para desarrolladores para conocer la cantidad máxima de puntos de referencia permitidos. |
NOT_FOUND |
No se pudo geocodificar al menos uno de los orígenes, destinos o puntos de referencia. |
OK |
La respuesta contiene un DirectionsResult válido. |
OVER_QUERY_LIMIT |
La página web superó el límite de solicitudes en un período demasiado corto. |
REQUEST_DENIED |
La página web no tiene permiso para usar el servicio Directions. |
UNKNOWN_ERROR |
No se pudo procesar una solicitud de instrucciones sobre cómo llegar debido a un error del servidor. La solicitud podría completarse si realizas un nuevo intento. |
ZERO_RESULTS |
No se pudo encontrar una ruta entre el origen y el destino. |
Interfaz DirectionsResult
Interfaz de google.maps.DirectionsResult
Es la respuesta de direcciones recuperada del servidor de direcciones. Puedes renderizarlos con un DirectionsRenderer
o analizar este objeto y renderizarlo por tu cuenta. Debes mostrar las advertencias y los avisos sobre derechos de autor como se indica en las Condiciones del Servicio de Google Maps Platform. Ten en cuenta que, si bien este resultado es similar a JSON, no es estrictamente JSON, ya que incluye indirectamente objetos LatLng
.
Propiedades | |
---|---|
request |
Tipo:
DirectionsRequest Es el DirectionsRequest que generó este resultado. |
routes |
Tipo:
Array<DirectionsRoute> Es un array de DirectionsRoute s, cada uno de los cuales contiene información sobre los tramos y los pasos que lo componen. Solo habrá una ruta, a menos que la DirectionsRequest se haya creado con provideRouteAlternatives establecido en true . |
available_travel_modes optional |
Tipo:
Array<TravelMode> optional Contiene un array de medios de transporte disponibles. Este campo se devuelve cuando una solicitud especifica un modo de viaje y no obtiene resultados. La matriz contiene los modos de viaje disponibles en los países del conjunto específico de waypoints. Este campo no se devuelve si uno o más de los puntos de referencia son "puntos de referencia de ruta". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Es un array de DirectionsGeocodedWaypoint , cada uno de los cuales contiene información sobre la geocodificación del origen, el destino y los puntos de referencia. |
Clase DirectionsRenderer
Clase google.maps.DirectionsRenderer
Renderiza las instrucciones obtenidas de DirectionsService
.
Esta clase extiende