{"schemaVersion":"server402.catalog.search.v1","generatedAt":"2026-07-30T11:17:07Z","generatedAtBeijing":"2026-07-30 19:17:07 CST","timezone":"Asia/Shanghai","query":"google-maps-traffic","expandedTerms":["commute time","distance between places","drive time","driving directions","google maps routes","map query","maps query","navigation route","road traffic","route lookup","route planning","traffic aware eta","traffic delay","travel time","交通情况","从a到b怎么走","地图查询","堵车","实时路况","导航路线","开车多久","谷歌地图","路径规划","路线查询","路线规划","驾车导航","驾车路线"],"filters":{"limit":10},"total":1,"services":[{"id":"google-maps-traffic","canonicalId":"google-maps-traffic","name":"Google Maps Traffic","displayName":"Google Maps Traffic","description":"Use this paid XIAO Google Maps Routes API service for route planning, driving directions, traffic-aware ETA, travel time, static travel time, traffic delay, route distance, legs, steps, and polyline output between an origin and destination. Strong keywords include map query, route lookup, driving directions, traffic-aware ETA, drive time, commute time, Google Maps Routes API, 地图查询, 谷歌地图, 路线查询, 路线规划, 导航路线, 驾车路线, 实时路况, 交通情况, 堵车, 开车多久, and 从A到B怎么走. It requires origin and destination. It supports addresses, Google Place IDs, and latitude/longitude waypoints. Unpaid calls return HTTP 402 before Google execution. This endpoint does not support standalone nearby search, POI/business search, place details, store hours, reviews, map tiles, or geocoding-only lookup.","descriptionForModel":"Use this paid XIAO Google Maps Routes API service for route planning, driving directions, traffic-aware ETA, travel time, static travel time, traffic delay, route distance, legs, steps, and polyline output between an origin and destination. Strong keywords include map query, route lookup, driving directions, traffic-aware ETA, drive time, commute time, Google Maps Routes API, 地图查询, 谷歌地图, 路线查询, 路线规划, 导航路线, 驾车路线, 实时路况, 交通情况, 堵车, 开车多久, and 从A到B怎么走. It requires origin and destination. It supports addresses, Google Place IDs, and latitude/longitude waypoints. Unpaid calls return HTTP 402 before Google execution. This endpoint does not support standalone nearby search, POI/business search, place details, store hours, reviews, map tiles, or geocoding-only lookup.","category":"maps-routes","keywords":["Google Maps traffic API","Google Maps Routes API","map query API","maps query","route planning","route planner","route lookup","directions","driving directions","navigation route","traffic-aware ETA","estimated arrival time","travel time","drive time","driving time","commute time","traffic delay","live traffic","road traffic","distance between places","origin destination route","地图查询","谷歌地图","路线查询","路线规划","路径规划","导航路线","驾车路线","驾车导航","实时路况","交通情况","交通拥堵","堵车","预计到达时间","开车多久","从A到B怎么走"],"useCases":["Get traffic-aware driving ETA and route distance between two places","Plan a route from origin to destination with Google Maps Routes API","Return route legs, steps, duration, static duration, traffic delay, and encoded polyline for AI agents","Answer route-related map queries such as 地图查询, 谷歌地图, 路线规划, 实时路况, 开车多久, or 从A到B怎么走 when two places are present"],"limitations":["Requires origin and destination; ask for the missing waypoint before invoking","Paid XIAO service; unpaid calls return HTTP 402 before any Google upstream request","Requires server-side GOOGLE_MAPS_API_KEY and GOOGLE_MAPS_BASE_URL configuration","Does not support standalone POI, nearby, place details, business hours, reviews, map tiles, or geocoding-only lookup"],"tags":["paid","xiao","google","google-maps","maps","routes","directions","traffic","eta","navigation","route-planning","route-lookup","map-query","maps-query","commute","live-traffic","road-traffic","traffic-data","drive-time","driving-time","travel-time","traffic-delay","estimated-arrival","semantic:google-maps-traffic","intent:route-planning","intent:traffic-aware-eta","intent:driving-directions","intent:map-query","intent:navigation-route","input:origin","input:destination","output:duration","output:traffic-delay","output:distance"],"method":"POST","endpoint":"/api/tools/google-maps-traffic","endpointAliases":["/api/v1/maps/traffic","/api/traffic","/api/maps/traffic","/api/v1/traffic/routes","/api/tools/google-maps-traffic","/api/services/google-maps-traffic/invoke"],"inputTypes":["object","array","string","boolean"],"outputTypes":["object","boolean","array","string","integer"],"inputSchema":{"properties":{"computeAlternativeRoutes":{"default":false,"type":"boolean"},"departureTime":{"description":"RFC3339 timestamp or now.","type":"string"},"destination":{"description":"Waypoint for Google Routes API. Provide exactly one of address, placeId, or location.latLng. Strings are treated as addresses.","properties":{"address":{"description":"Free-form address or place description.","type":"string"},"location":{"properties":{"heading":{"description":"Optional heading in degrees when using latLng.","maximum":360,"minimum":0,"type":"integer"},"latLng":{"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"type":"object"}},"type":"object"},"placeId":{"description":"Google Place ID.","type":"string"},"sideOfRoad":{"description":"Whether the waypoint should be on the road side.","type":"boolean"},"vehicleStopover":{"description":"Whether the waypoint is a stopover.","type":"boolean"},"via":{"description":"Whether the waypoint is a pass-through point.","type":"boolean"}},"type":"object"},"extraComputations":{"items":{"enum":["TOLLS","TRAFFIC_ON_POLYLINE","HTML_FORMATTED_NAVIGATION_INSTRUCTIONS"],"type":"string"},"type":"array"},"intermediates":{"description":"Optional intermediate waypoints in travel order.","items":{"description":"Waypoint for Google Routes API. Provide exactly one of address, placeId, or location.latLng. Strings are treated as addresses.","properties":{"address":{"description":"Free-form address or place description.","type":"string"},"location":{"properties":{"heading":{"description":"Optional heading in degrees when using latLng.","maximum":360,"minimum":0,"type":"integer"},"latLng":{"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"type":"object"}},"type":"object"},"placeId":{"description":"Google Place ID.","type":"string"},"sideOfRoad":{"description":"Whether the waypoint should be on the road side.","type":"boolean"},"vehicleStopover":{"description":"Whether the waypoint is a stopover.","type":"boolean"},"via":{"description":"Whether the waypoint is a pass-through point.","type":"boolean"}},"type":"object"},"type":"array"},"languageCode":{"default":"en-US","description":"BCP-47 locale used for route labels.","type":"string"},"origin":{"description":"Waypoint for Google Routes API. Provide exactly one of address, placeId, or location.latLng. Strings are treated as addresses.","properties":{"address":{"description":"Free-form address or place description.","type":"string"},"location":{"properties":{"heading":{"description":"Optional heading in degrees when using latLng.","maximum":360,"minimum":0,"type":"integer"},"latLng":{"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"type":"object"}},"type":"object"},"placeId":{"description":"Google Place ID.","type":"string"},"sideOfRoad":{"description":"Whether the waypoint should be on the road side.","type":"boolean"},"vehicleStopover":{"description":"Whether the waypoint is a stopover.","type":"boolean"},"via":{"description":"Whether the waypoint is a pass-through point.","type":"boolean"}},"type":"object"},"regionCode":{"description":"Optional ISO 3166-1 alpha-2 region code.","type":"string"},"routeModifiers":{"properties":{"avoidFerries":{"type":"boolean"},"avoidHighways":{"type":"boolean"},"avoidIndoor":{"type":"boolean"},"avoidTolls":{"type":"boolean"}},"type":"object"},"routingPreference":{"default":"TRAFFIC_AWARE_OPTIMAL","enum":["TRAFFIC_UNAWARE","TRAFFIC_AWARE","TRAFFIC_AWARE_OPTIMAL"],"type":"string"},"trafficModel":{"default":"BEST_GUESS","enum":["BEST_GUESS","OPTIMISTIC","PESSIMISTIC"],"type":"string"},"travelMode":{"default":"DRIVE","enum":["DRIVE","BICYCLE","WALK","TWO_WHEELER","TRANSIT"],"type":"string"},"units":{"default":"METRIC","enum":["METRIC","IMPERIAL"],"type":"string"}},"required":["origin","destination"],"type":"object"},"outputSchema":{"properties":{"agent_id":{"type":"string"},"compute_alternative_routes":{"type":"boolean"},"departure_time":{"type":"string"},"destination":{"type":"object"},"fallback_info":{"type":"object"},"geocoding_results":{"type":"object"},"intermediates":{"items":{"type":"object"},"type":"array"},"language_code":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"origin":{"type":"object"},"region_code":{"type":"string"},"request_id":{"type":"string"},"route_count":{"type":"integer"},"route_modifiers":{"type":"object"},"routes":{"items":{"properties":{"description":{"type":"string"},"distance_meters":{"type":"integer"},"distance_text":{"type":"string"},"duration_seconds":{"type":"integer"},"duration_text":{"type":"string"},"legs":{"items":{"type":"object"},"type":"array"},"localized_values":{"type":"object"},"optimized_intermediate_waypoint_indexes":{"items":{"type":"integer"},"type":"array"},"polyline":{"type":"object"},"route_index":{"type":"integer"},"route_labels":{"items":{"type":"string"},"type":"array"},"static_duration_seconds":{"type":"integer"},"static_duration_text":{"type":"string"},"traffic_delay_seconds":{"type":"integer"},"travel_advisory":{"type":"object"},"warning_messages":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"routing_preference":{"type":"string"},"source":{"type":"string"},"source_urls":{"items":{"type":"string"},"type":"array"},"status":{"type":"string"},"traffic_enabled":{"type":"boolean"},"traffic_model":{"type":"string"},"travel_mode":{"type":"string"},"units":{"type":"string"}},"required":["status","agent_id","request_id","origin","destination","travel_mode","routing_preference","routes","source","source_urls"],"type":"object"},"exampleRequest":{"departureTime":"now","destination":"Shibuya Crossing, Tokyo, Japan","languageCode":"en-US","origin":"Tokyo Station, Tokyo, Japan","routingPreference":"TRAFFIC_AWARE_OPTIMAL","trafficModel":"BEST_GUESS","travelMode":"DRIVE","units":"METRIC"},"exampleResponse":{"agent_id":"google-maps-traffic","route_count":1,"routes":[{"distance_meters":6500,"distance_text":"6.5 km","duration_seconds":1260,"polyline":{"encoded_polyline":"example"},"route_index":0,"static_duration_seconds":1020,"traffic_delay_seconds":240}],"routing_preference":"TRAFFIC_AWARE_OPTIMAL","source":"Google Maps Routes API","status":"ok","traffic_enabled":true,"travel_mode":"DRIVE"},"pricing":{"amountCents":1,"amountMicros":10000,"currency":"XIAO","policyId":"google-maps-traffic","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"payment":{"providerId":"xiao-wallet","provider":"x402_xiao_wallet"},"quality":{"qualityScore":43,"healthStatus":"configured","healthCheckedAt":"2026-07-30T07:20:50Z","latencyMs":7,"successRate":1,"callCount":5,"executionCount":3,"successCount":3,"errorCount":0,"paymentRequireds":2,"lastCallAt":"2026-07-30T10:17:02Z"},"discovery":{"toolName":"google_maps_traffic","searchText":"google-maps-traffic Google Maps Traffic Use this paid XIAO Google Maps Routes API service for route planning, driving directions, traffic-aware ETA, travel time, static travel time, traffic delay, route distance, legs, steps, and polyline output between an origin and destination. Strong keywords include map query, route lookup, driving directions, traffic-aware ETA, drive time, commute time, Google Maps Routes API, 地图查询, 谷歌地图, 路线查询, 路线规划, 导航路线, 驾车路线, 实时路况, 交通情况, 堵车, 开车多久, and 从A到B怎么走. It requires origin and destination. It supports addresses, Google Place IDs, and latitude/longitude waypoints. Unpaid calls return HTTP 402 before Google execution. This endpoint does not support standalone nearby search, POI/business search, place details, store hours, reviews, map tiles, or geocoding-only lookup. Use this paid XIAO Google Maps Routes API service for route planning, driving directions, traffic-aware ETA, travel time, static travel time, traffic delay, route distance, legs, steps, and polyline output between an origin and destination. Strong keywords include map query, route lookup, driving directions, traffic-aware ETA, drive time, commute time, Google Maps Routes API, 地图查询, 谷歌地图, 路线查询, 路线规划, 导航路线, 驾车路线, 实时路况, 交通情况, 堵车, 开车多久, and 从A到B怎么走. It requires origin and destination. It supports addresses, Google Place IDs, and latitude/longitude waypoints. Unpaid calls return HTTP 402 before Google execution. This endpoint does not support standalone nearby search, POI/business search, place details, store hours, reviews, map tiles, or geocoding-only lookup. maps-routes object array string boolean object boolean array string integer paid xiao google google-maps maps routes directions traffic eta navigation route-planning route-lookup map-query maps-query commute live-traffic road-traffic traffic-data drive-time driving-time travel-time traffic-delay estimated-arrival semantic:google-maps-traffic intent:route-planning intent:traffic-aware-eta intent:driving-directions intent:map-query intent:navigation-route input:origin input:destination output:duration output:traffic-delay output:distance Google Maps traffic API Google Maps Routes API map query API maps query route planning route planner route lookup directions driving directions navigation route traffic-aware ETA estimated arrival time travel time drive time driving time commute time traffic delay live traffic road traffic distance between places origin destination route 地图查询 谷歌地图 路线查询 路线规划 路径规划 导航路线 驾车路线 驾车导航 实时路况 交通情况 交通拥堵 堵车 预计到达时间 开车多久 从A到B怎么走 Get traffic-aware driving ETA and route distance between two places Plan a route from origin to destination with Google Maps Routes API Return route legs, steps, duration, static duration, traffic delay, and encoded polyline for AI agents Answer route-related map queries such as 地图查询, 谷歌地图, 路线规划, 实时路况, 开车多久, or 从A到B怎么走 when two places are present Requires origin and destination; ask for the missing waypoint before invoking Paid XIAO service; unpaid calls return HTTP 402 before any Google upstream request Requires server-side GOOGLE_MAPS_API_KEY and GOOGLE_MAPS_BASE_URL configuration Does not support standalone POI, nearby, place details, business hours, reviews, map tiles, or geocoding-only lookup /api/tools/google-maps-traffic","aliases":["Google Maps Traffic","maps-routes","paid","xiao","google","google-maps","maps","routes","directions","traffic","eta","navigation","route-planning","route-lookup","map-query","maps-query","commute","live-traffic","road-traffic","traffic-data","drive-time","driving-time","travel-time","traffic-delay","estimated-arrival","semantic:google-maps-traffic","intent:route-planning","intent:traffic-aware-eta","intent:driving-directions","intent:map-query","intent:navigation-route","input:origin","input:destination","output:duration","output:traffic-delay","output:distance","Google Maps traffic API","Google Maps Routes API","map query API","maps query","route planning","route planner","route lookup","driving directions","navigation route","traffic-aware ETA","estimated arrival time","travel time","drive time","driving time","commute time","traffic delay","live traffic","road traffic","distance between places","origin destination route","地图查询","谷歌地图","路线查询","路线规划","路径规划","导航路线","驾车路线","驾车导航","实时路况","交通情况","交通拥堵","堵车","预计到达时间","开车多久","从A到B怎么走","google-maps-traffic","google_maps_traffic","/api/tools/google-maps-traffic"],"localeHints":["en","zh"],"useCases":["Get traffic-aware driving ETA and route distance between two places","Plan a route from origin to destination with Google Maps Routes API","Return route legs, steps, duration, static duration, traffic delay, and encoded polyline for AI agents","Answer route-related map queries such as 地图查询, 谷歌地图, 路线规划, 实时路况, 开车多久, or 从A到B怎么走 when two places are present"],"limitations":["Requires origin and destination; ask for the missing waypoint before invoking","Paid XIAO service; unpaid calls return HTTP 402 before any Google upstream request","Requires server-side GOOGLE_MAPS_API_KEY and GOOGLE_MAPS_BASE_URL configuration","Does not support standalone POI, nearby, place details, business hours, reviews, map tiles, or geocoding-only lookup"],"paymentFlow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}},"paymentHint":"Call POST /api/tools/google-maps-traffic once to receive HTTP 402 with accepts[] requirements. Open https://xiaopay.top to obtain XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId, then retry with X402-Guarantee. If you need the legacy reusable token flow, create a payment with POST /api/payments using serviceId=\"google-maps-traffic\".","retryHint":"If the service returns HTTP 402, open https://xiaopay.top to obtain XIAO, then retry with X402-Guarantee for the guarantee flow or X-Payment-Token for the legacy token flow.","requiredState":"published, enabled"},"complexity":"moderate","typicalResponseTime":"1500ms","cacheable":false,"idempotent":true,"outputFormat":"json","relatedServices":["maps-directions-api","distance-matrix-api","traffic-data-api","places-search-api","geocoding-api"],"alternativeServices":["/api/v1/maps/traffic","/api/traffic","/api/maps/traffic","/api/v1/traffic/routes","/api/tools/google-maps-traffic","/api/services/google-maps-traffic/invoke"],"requiredContext":["origin","destination","google-maps-api-key"],"errorExamples":[{"input":{},"error":"origin: waypoint is required","statusCode":400},{"input":{"origin":"Tokyo Station"},"error":"destination: waypoint is required","statusCode":400}],"sla":{"uptime":"99.5%","maxLatency":"5000ms"},"matchScore":908,"matchTerms":["google maps traffic","google","maps","traffic","Google Maps routes and traffic","commute time","distance between places","drive time","driving directions","google maps routes","map query","maps query","navigation route","road traffic","route lookup","route planning","traffic aware eta","traffic delay","travel time","交通情况","从a到b怎么走","地图查询","堵车","实时路况","导航路线","开车多久","谷歌地图","路径规划","路线查询","路线规划","驾车导航","驾车路线"],"why":"Matched Google Maps route, traffic, ETA, or distance intent for \"Google Maps Traffic\". Use it when the request has origin + destination; unpaid calls return HTTP 402 before Google upstream execution. Price is XIAO 0.01 per policy google-maps-traffic.","whyMatched":"Matched Google Maps route, traffic, ETA, or distance intent for \"Google Maps Traffic\". Use it when the request has origin + destination; unpaid calls return HTTP 402 before Google upstream execution. Price is XIAO 0.01 per policy google-maps-traffic."}],"agents":[{"id":"google-maps-traffic","name":"Google Maps Traffic","description":"Use this paid XIAO Google Maps Routes API service for route planning, driving directions, traffic-aware ETA, travel time, static travel time, traffic delay, route distance, legs, steps, and polyline output between an origin and destination. Strong keywords include map query, route lookup, driving directions, traffic-aware ETA, drive time, commute time, Google Maps Routes API, 地图查询, 谷歌地图, 路线查询, 路线规划, 导航路线, 驾车路线, 实时路况, 交通情况, 堵车, 开车多久, and 从A到B怎么走. It requires origin and destination. It supports addresses, Google Place IDs, and latitude/longitude waypoints. Unpaid calls return HTTP 402 before Google execution. This endpoint does not support standalone nearby search, POI/business search, place details, store hours, reviews, map tiles, or geocoding-only lookup.","endpoint":"/api/tools/google-maps-traffic","method":"POST","auth_type":"api_key + x402_xiao_wallet http_402","billing_method":"per_call","pricing":{"amountCents":1,"amountMicros":10000,"currency":"XIAO","policyId":"google-maps-traffic","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"input_schema":{"properties":{"computeAlternativeRoutes":{"default":false,"type":"boolean"},"departureTime":{"description":"RFC3339 timestamp or now.","type":"string"},"destination":{"description":"Waypoint for Google Routes API. Provide exactly one of address, placeId, or location.latLng. Strings are treated as addresses.","properties":{"address":{"description":"Free-form address or place description.","type":"string"},"location":{"properties":{"heading":{"description":"Optional heading in degrees when using latLng.","maximum":360,"minimum":0,"type":"integer"},"latLng":{"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"type":"object"}},"type":"object"},"placeId":{"description":"Google Place ID.","type":"string"},"sideOfRoad":{"description":"Whether the waypoint should be on the road side.","type":"boolean"},"vehicleStopover":{"description":"Whether the waypoint is a stopover.","type":"boolean"},"via":{"description":"Whether the waypoint is a pass-through point.","type":"boolean"}},"type":"object"},"extraComputations":{"items":{"enum":["TOLLS","TRAFFIC_ON_POLYLINE","HTML_FORMATTED_NAVIGATION_INSTRUCTIONS"],"type":"string"},"type":"array"},"intermediates":{"description":"Optional intermediate waypoints in travel order.","items":{"description":"Waypoint for Google Routes API. Provide exactly one of address, placeId, or location.latLng. Strings are treated as addresses.","properties":{"address":{"description":"Free-form address or place description.","type":"string"},"location":{"properties":{"heading":{"description":"Optional heading in degrees when using latLng.","maximum":360,"minimum":0,"type":"integer"},"latLng":{"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"type":"object"}},"type":"object"},"placeId":{"description":"Google Place ID.","type":"string"},"sideOfRoad":{"description":"Whether the waypoint should be on the road side.","type":"boolean"},"vehicleStopover":{"description":"Whether the waypoint is a stopover.","type":"boolean"},"via":{"description":"Whether the waypoint is a pass-through point.","type":"boolean"}},"type":"object"},"type":"array"},"languageCode":{"default":"en-US","description":"BCP-47 locale used for route labels.","type":"string"},"origin":{"description":"Waypoint for Google Routes API. Provide exactly one of address, placeId, or location.latLng. Strings are treated as addresses.","properties":{"address":{"description":"Free-form address or place description.","type":"string"},"location":{"properties":{"heading":{"description":"Optional heading in degrees when using latLng.","maximum":360,"minimum":0,"type":"integer"},"latLng":{"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"type":"object"}},"type":"object"},"placeId":{"description":"Google Place ID.","type":"string"},"sideOfRoad":{"description":"Whether the waypoint should be on the road side.","type":"boolean"},"vehicleStopover":{"description":"Whether the waypoint is a stopover.","type":"boolean"},"via":{"description":"Whether the waypoint is a pass-through point.","type":"boolean"}},"type":"object"},"regionCode":{"description":"Optional ISO 3166-1 alpha-2 region code.","type":"string"},"routeModifiers":{"properties":{"avoidFerries":{"type":"boolean"},"avoidHighways":{"type":"boolean"},"avoidIndoor":{"type":"boolean"},"avoidTolls":{"type":"boolean"}},"type":"object"},"routingPreference":{"default":"TRAFFIC_AWARE_OPTIMAL","enum":["TRAFFIC_UNAWARE","TRAFFIC_AWARE","TRAFFIC_AWARE_OPTIMAL"],"type":"string"},"trafficModel":{"default":"BEST_GUESS","enum":["BEST_GUESS","OPTIMISTIC","PESSIMISTIC"],"type":"string"},"travelMode":{"default":"DRIVE","enum":["DRIVE","BICYCLE","WALK","TWO_WHEELER","TRANSIT"],"type":"string"},"units":{"default":"METRIC","enum":["METRIC","IMPERIAL"],"type":"string"}},"required":["origin","destination"],"type":"object"},"output_schema":{"properties":{"agent_id":{"type":"string"},"compute_alternative_routes":{"type":"boolean"},"departure_time":{"type":"string"},"destination":{"type":"object"},"fallback_info":{"type":"object"},"geocoding_results":{"type":"object"},"intermediates":{"items":{"type":"object"},"type":"array"},"language_code":{"type":"string"},"notes":{"items":{"type":"string"},"type":"array"},"origin":{"type":"object"},"region_code":{"type":"string"},"request_id":{"type":"string"},"route_count":{"type":"integer"},"route_modifiers":{"type":"object"},"routes":{"items":{"properties":{"description":{"type":"string"},"distance_meters":{"type":"integer"},"distance_text":{"type":"string"},"duration_seconds":{"type":"integer"},"duration_text":{"type":"string"},"legs":{"items":{"type":"object"},"type":"array"},"localized_values":{"type":"object"},"optimized_intermediate_waypoint_indexes":{"items":{"type":"integer"},"type":"array"},"polyline":{"type":"object"},"route_index":{"type":"integer"},"route_labels":{"items":{"type":"string"},"type":"array"},"static_duration_seconds":{"type":"integer"},"static_duration_text":{"type":"string"},"traffic_delay_seconds":{"type":"integer"},"travel_advisory":{"type":"object"},"warning_messages":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"routing_preference":{"type":"string"},"source":{"type":"string"},"source_urls":{"items":{"type":"string"},"type":"array"},"status":{"type":"string"},"traffic_enabled":{"type":"boolean"},"traffic_model":{"type":"string"},"travel_mode":{"type":"string"},"units":{"type":"string"}},"required":["status","agent_id","request_id","origin","destination","travel_mode","routing_preference","routes","source","source_urls"],"type":"object"},"tags":["paid","xiao","google","google-maps","maps","routes","directions","traffic","eta","navigation","route-planning","route-lookup","map-query","maps-query","commute","live-traffic","road-traffic","traffic-data","drive-time","driving-time","travel-time","traffic-delay","estimated-arrival","semantic:google-maps-traffic","intent:route-planning","intent:traffic-aware-eta","intent:driving-directions","intent:map-query","intent:navigation-route","input:origin","input:destination","output:duration","output:traffic-delay","output:distance"],"category":"maps-routes"}],"demandCapture":{"queryRecorded":true,"demandBearing":true,"status":"published-and-planned-candidates","recommendedAction":"compare-published-services-and-request-missing-fit","message":"Published services and planned API candidates both matched. Prefer a published callable service when it fits; otherwise request early access for the planned candidate that better matches the task.","matchedPlannedServices":[{"id":"popular-product-google-pixel-pro-comparison-api","name":"Google Pixel Pro 比价 API","category":"价格/热门商品/比价","availability":"可新增","status":"planned / early-access","servicePage":"https://x402vip.com/services/popular-product-google-pixel-pro-comparison-api","llmsText":"https://x402vip.com/services/popular-product-google-pixel-pro-comparison-api/llms.txt","requestAccessUrl":"https://x402vip.com/api/planned-services/request-access","candidateApiPaths":["https://x402vip.com/api/prices/products/google-pixel-pro/comparison","https://x402vip.com/api/price/products/google-pixel-pro/comparison","https://x402vip.com/api/products/google-pixel-pro/comparison","https://x402vip.com/api/shopping/google-pixel-pro/comparison"],"keywords":["popular-product-google-pixel-pro-comparison-api","popular-product-google-pixel-pro-comparison","popular product google pixel pro comparison","Google Pixel Pro 比价 API","Google Pixel Pro","Google","手机","google-pixel-pro","google pixel pro","Google Pixel Pro price","Google Pixel Pro buy","Google Pixel Pro purchase","Google Pixel Pro shopping","Google Pixel Pro coupon","Google Pixel Pro sale","Google Pixel Pro deal","Google Pixel Pro lowest price","Google Pixel Pro price comparison","Google Pixel Pro where to buy","Google Pixel Pro 价格","Google Pixel Pro 比价","Google Pixel Pro 最低价","Google Pixel Pro 特价","Google Pixel Pro 优惠","Google Pixel Pro 购买链接","Google Pixel Pro 哪里买","pixel pro","pixel pro price","pixel pro 比价","pixel pro 最低价","pixel pro 特价","android phone","android phone price","android phone 比价","android phone 最低价","android phone 特价","Google Google Pixel Pro","Google price","Google deal","Google 比价","Google 最低价","Google 特价","比价","比价 Google Pixel Pro","google-pixel-pro comparison","price comparison","price comparison Google Pixel Pro","compare prices","Google Pixel Pro compare prices","compare prices Google Pixel Pro","compare retailers","Google Pixel Pro compare retailers","compare retailers Google Pixel Pro","same product cheaper","Google Pixel Pro same product cheaper","same product cheaper Google Pixel Pro","价格比较","Google Pixel Pro 价格比较","价格比较 Google Pixel Pro","全网比价","Google Pixel Pro 全网比价","全网比价 Google Pixel Pro","同款比价","Google Pixel Pro 同款比价","同款比价 Google Pixel Pro"],"tags":["comparison","比价","热门商品","popular product","product price bait","手机","Google","price","价格"],"product":{"id":"google-pixel-pro","name":"Google Pixel Pro","brand":"Google","category":"手机","referencePrice":"$999","priceCurrency":"USD","buyUrl":"https://www.amazon.com/s?k=Google+Pixel+Pro","tags":["热门商品","popular product","手机","Google"]},"matchRank":1,"matchReason":"Search query matched this planned demand candidate; request-access and candidate path visits are aggregated for launch prioritization."}],"requestAccessUrl":"https://x402vip.com/api/planned-services/request-access","requestAccessBody":{"query":"google-maps-traffic","serviceId":"popular-product-google-pixel-pro-comparison-api","task":"Describe the exact input data, desired output schema, freshness, volume, budget, and whether a published service failed to fit.","useCase":"AI/Agent searched for: google-maps-traffic"},"plannedCatalogUrl":"https://x402vip.com/api/demand-capture","notes":["Every non-admin /api/catalog/search?q=... request is appended to natural_traffic.jsonl and aggregated in /api/admin/demand-intents.","Submitting requestAccessBody adds a stronger commercial/early-access signal than search alone.","Planned API candidates are not callable yet; use /api/catalog services for currently callable paid APIs."]},"nextActions":["Inspect services[].inputSchema, services[].outputSchema, services[].pricing, and services[].discovery.paymentFlow.","Call the selected /api/tools/* endpoint once without payment to receive HTTP 402 payment requirements, open xiaopay.top to obtain XIAO, then retry with X402-Guarantee.","If services are missing or too broad, inspect demandCapture.matchedPlannedServices.","POST demandCapture.requestAccessBody to demandCapture.requestAccessUrl to record a stronger early-access demand signal."],"payment":{"paymentHeader":"X-Payment-Token","createPayment":"/api/payments","verifyPayment":"/api/payments/{paymentId}","token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]},"flow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}}}}