{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"⚡ Tutorial for the first trip in electrical vehicle","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"-tutorial-for-the-first-trip-in-electrical-vehicle","__idx":0},"children":["⚡ Tutorial for the first trip in electrical vehicle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"className":"float-right shadow"},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/evsmartrouting-service-map.6e960d67de2857328566f604224ac6d4fe625abaabccb9022236ecfb6e73957d.9c1bb791.jpg","alt":"Illustration of near POI service"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial explains ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["how to perform a simple electric vehicle route calculation"]}," using the EV Smart Routing API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your vehicle's battery can't reach the final destination, the route returned will ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["include charging stations"]}," (also called ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["step points"]},") automatically.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"We’ll calculate a trip from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paris to Lyon"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-tutorial-structure","__idx":1},"children":["🧭 Tutorial Structure"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["🔑 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#1-how-to-get-the-vehicle-key"},"children":["How to get the vehicle key"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Get the vehicle brand"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Get the vehicle key ID"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["📍 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#2-optional-convert-a-postal-address-to-coordinates"},"children":["Optional: Convert address to coordinates"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["🚗 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#3-run-the-trip-computation"},"children":["Run the EV Smart Routing trip computation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["📊 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#4-use-the-results"},"children":["Use the results"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1--how-to-get-the-vehicle-key","__idx":2},"children":["1. 🔑 How to Get the Vehicle Key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To compute a route for an electric vehicle, the API needs a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["vehicle key ID"]},", which identifies the EV model. To get it:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-get-the-brand","__idx":3},"children":["🏭 Get the Brand"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call the API ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/getbrands"]}," to list all available vehicle brands."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-request","__idx":4},"children":["🔧 Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET ${HOST_URL}/bgis/service/vehicle/1.0/getbrands\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response (truncated):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n{\n  \"brands\": [{\n      \"id\": \"609a4642c9cb5b0b1846c0d4\",\n      \"label\": \"Aiways\"\n    }, {\n      \"id\": \"609a4642c9cb5b0b1846c0d7\",\n      \"label\": \"Audi\"\n    }, {\n      \"id\": \"609a4642c9cb5b0b1846c0e6\",\n      \"label\": \"BMW\"\n    },\n    . . .\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See more details on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the response you obtain a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JSON"]}," object with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brands"]}," field. This field is an array of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brand"]}," objects."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brand"]}," object contains two important fields, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}," represents the constructor name. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," is the unique identifier of the entry."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}," can be used to fill a drop-down list or to perform a search based on the brand name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the brand name is selected, store the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},". This ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," will be used in the next step to get the vehicle key id."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," of brand ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Audi"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["609a4642c9cb5b0b1846c0d7"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," The id is unique only for on one environment (production, preproduction, etc). When your application switches environments (for example from preproduction to production), you will need to call the API again."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-select-the-vehicle-get-vehicle-key-id","__idx":5},"children":["🚙 Select the Vehicle (Get Vehicle Key ID)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To compute the trip, the EV Smart Routing API needs to know which vehicle to use. The vehicle is represented by an identifier, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle key id"]},". This identifier is an simple string like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eb72114c-1f74-4854-b4ce-c2b3f06405d5"]}," for an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Audi e-Tron 50 Quattro"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NOTE: The  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[" vehicle key id"]}," is the same on all environments (production and preproduction)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To do this selection we have two main APIs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A helper API to fill a drop-down list. See the chapter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Select the vehicle by drop list"]}," below."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An API to find or list the vehicles. See the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Find vehicle"]}," chapter below."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-select-the-vehicle-from-a-drop-down-list-optional","__idx":6},"children":["🚘 Select the vehicle from a drop-down list (optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["vehicle key ID"]}," is a unique string used to identify a vehicle model.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"🛑 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," It is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["same across all environments"]}," (production, preproduction, etc)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-1-get-vehicle-names-for-a-brand","__idx":7},"children":["🧩 1. Get vehicle names for a brand"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nGET ${HOST_URL}/bgis/service/vehicle/1.0/getlevelvehicleinfo?level=NAME&brandId=609a4642c9cb5b0b1846c0d7\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is a JSON array."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n[\"Q4 e-tron 35\", \"Q4 e-tron 40\", \"R8 e-tron\", \"e-tron 50 Quattro\", ...]\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use it to fill a drop-down list in your user interface."," ","Get the searched vehicle name to fill the next step request url and the final ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find vehicle"]}," request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-2-get-the-available-battery-names-for-the-vehicle-name","__idx":8},"children":["🔋 2. Get the available battery names for the vehicle name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The battery name is the public or commercial name of battery like \"50\". This information should not be confused with the actual battery capacity (kWh). For example, a battery with 52 kWh of capacity is called \"50\"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nGET ${HOST_URL}/bgis/service/vehicle/1.0/getlevelvehicleinfo?level=BATTERY_NAME&brandId=609a4642c9cb5b0b1846c0d7&name=e-tron+50+Quattro\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is a JSON array."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n[\"64.7\"]\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use it to fill a drop-down list in your user interface."," ","Get the searched battery name to fill the next step request url and the final ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find vehicle"]}," request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-3-get-available-chargers-for-the-vehicle-name-and-battery-name","__idx":9},"children":["⚡ 3. Get available chargers for the vehicle name and battery name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["a."]}," List of DC chargers"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nGET ${HOST_URL}/bgis/service/vehicle/1.0/getlevelvehicleinfo?level=CHARGE_POWER_DC&brandId=609a4642c9cb5b0b1846c0d7&name=e-tron+50+Quattro&batteryName=64.7\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is a JSON array."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n[\"120.0\"]\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use it to fill a drop-down list in your user interface."," ","Get the searched DC charge to fill the next step request url and the final ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find vehicle"]}," request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["b."]}," List of AC chargers"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nGET ${HOST_URL}/bgis/service/vehicle/1.0/getlevelvehicleinfo?level=CHARGE_POWER_AC&brandId=609a4642c9cb5b0b1846c0d7&name=e-tron+50+Quattro&batteryName=64.7&chargerPowerDC=120.0\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is a JSON array."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n[\"120.0\"]\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use it to fill a drop-down list in your user interface."," ","Get the searched AC charge to fill the final ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find vehicle"]}," request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-4-get-the-vehicle-key-id-","__idx":10},"children":["🆔 4. Get the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle key id"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now, we have all the elements to perform a request with the find vehicle API. See the next chapter."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🔗 See more details in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-find-vehicle","__idx":11},"children":["🔎 Find vehicle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This API lets you retrieve the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle key id"]}," (needed for trip computation) and detailed vehicle information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["🧩 Get a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single vehicle"]}," if all required details are known."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["📋 Get a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["list of vehicles"]}," for a specific brand."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n{\n    \"brandId\": \"609a4642c9cb5b0b1846c0d7\",\n    \"name\": \"e-tron 50 Quattro\",\n    \"batteryName\": \"64.7\",\n    \"chargerPowerDC\": 120.0,\n    \"chargerPowerAC\": 11.0,\n    \"enableDatasheet\": false\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n{\n    \"vehicles\": [\n        {\n            \"key\": \"eb72114c-1f74-4854-b4ce-c2b3f06405d5\",\n            \"brandId\": \"609a4642c9cb5b0b1846c0d7\",\n            \"brandName\": \"Audi\",\n            \"name\": \"e-tron 50 Quattro\",\n            \"year\": \"2020\",\n            \"motorType\": \"EV\",\n            \"batteryName\": \"64.7\",\n            \"connectorTypes\": [\n                32,\n                38,\n                48\n            ],\n            \"chargerPowerAcThreePhases\": 11.0,\n            \"chargerPowerDC\": 120.0\n        }\n    ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle key id"]}," is represented by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]}," field. The value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eb72114c-1f74-4854-b4ce-c2b3f06405d5"]}," will be used to run the trip computation in the next chapter."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-get-all-vehicles-for-a-brand","__idx":12},"children":["📚 Get All Vehicles for a Brand"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here is another example to get all the vehicles for a brand."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nPOST /bgis/service/vehicle/1.0/findvehicles\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payload:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"brandId\": \"609a4642c9cb5b0b1846c0d7\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the response you will find all vehicles for this particular brand."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See more details in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-how-to-convert-a-postal-address-to-coordinates","__idx":13},"children":["📍 How to convert a postal address to coordinates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you already have GPS coordinates for your trip (lat/lon), you can skip this section."," ","Otherwise, use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["geocoding"]}," to convert a postal address to coordinates."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The EV Smart Routing API runs with coordinates (longitude and latitude): if you have a postal address, you need to find the coordinate of this address."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To do this, 2 APIs are available:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Geocoding"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Auto-complete"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-the-coordinate-via-the-geocoding-api","__idx":14},"children":["Get the coordinate via the Geocoding API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This API can take the postal address in categorized fields and returns the coordinate and postal address."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," field contains subfields like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["street"]},". More fields are available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}," field defines the language in search and response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximumResult"]}," field defines the maximum results to be returned in the response."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nPOST ${HOST_URL}/bgis/service/geocoding/1.0\n{\n\t\"address\": {\n\t\t\"country\":\"France\",\n\t\t\"city\": \"Paris\",\n\t\t\"street\": \"villa des pyrénées\"\n\t},\n\t\"searchType\": \"FUZZY\",\n\t\"maximumResult\": 2,\n\t\"language\": \"fr\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n{\n    \"extent\": {\n        \"minLon\": 2.40518,\n        \"minLat\": 48.8533,\n        \"maxLon\": 2.40587,\n        \"maxLat\": 48.85351\n    },\n    \"elements\": [\n        {\n            \"boundingBox\": {\n                \"minLon\": 2.40518,\n                \"minLat\": 48.8533,\n                \"maxLon\": 2.40587,\n                \"maxLat\": 48.85351\n            },\n            \"coordinate\": {\n                \"lon\": 2.40552,\n                \"lat\": 48.85342\n            },\n            \"distanceFromRequest\": 0.0,\n            \"postalAddress\": {\n                \"countryCode\": \"FRA\",\n                \"country\": \"France\",\n                \"state\": \"Île-de-France\",\n                \"county\": \"Paris\",\n                \"city\": \"Paris\",\n                \"district\": \"Paris 20e Arrondissement\",\n                \"postalCode\": \"75020\",\n                \"street\": \"Villa des Pyrénées\",\n                \"streetNumber\": \"1\"\n            },\n            \"postalAddressClassType\": \"ROAD_FOURTH\",\n            \"postalAddressClassId\": 4048,\n            \"postalAddressExactStreeNumber\": false,\n            \"angle\": 62.0,\n            \"administrativeSpeedLimit\": 0.0,\n            \"relevanceScore\": 1.0,\n            \"countryRelevanceScore\": 1.0,\n            \"cityRelevanceScore\": 1.0,\n            \"postalCodeRelevanceScore\": 1.0,\n            \"streetRelevanceScore\": 1.0,\n            \"streetNumberRelevanceScore\": 1.0,\n            \"segmentId\": 0\n        }\n    ],\n    \"maximumResult\": 1\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["elements"]}," array, the first element is the best match found by the API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can take the longitude and latitude values of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinate"]}," field of the first element."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This coordinate will be used by the EV Smart Routing API to perform the trip computation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See more details in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-get-the-coordinate-via-auto-complete-api","__idx":15},"children":["✨ Get the coordinate via Auto-complete API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This API can take the postal address, place or POI name as free text and returns the place name and the coordinate."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place"]}," field defines the postal address, place or POI name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinate"]}," field is used to select the continent (Europe, North America, Asia, etc.)."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT:"]}," this feature is only available with providers ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herehlp"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nominatim"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addok"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nPOST ${HOST_URL}/bgis/service/geocoding/autocomplete/1.0\n{\n    \"geoserver\": \"herehlp\",\n    \"coordinate\": {\n        \"longitude\": 2.3412,\n        \"latitude\": 48.85692999999998\n    },\n    \"place\": \"lyon\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n{\n    \"items\": [\n        {\n            \"elemType\": \"locality\",\n            \"place\": \"Lyon, Auvergne-Rhône-Alpes, France\",\n            \"addressLabel\": \"Lyon, Auvergne-Rhône-Alpes, France\",\n            \"coordinate\": {\n                \"longitude\": 4.82965,\n                \"latitude\": 45.75917\n            },\n            \"distance\": 392185\n        },\n        {\n            \"elemType\": \"street\",\n            \"place\": \"Rue de Lyon, 75012 Paris, France\",\n            \"addressLabel\": \"Rue de Lyon, 75012 Paris, France\",\n            \"coordinate\": {\n                \"longitude\": 2.37095,\n                \"latitude\": 48.84927\n            },\n            \"distance\": 2337\n        },\n        ...\n    ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items"]}," array, the first item is the best match found by the API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can take the longitude and latitude values of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinate"]}," field of the first item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This coordinate will be used by the EV Smart Routing API to perform the trip computation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See more details in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-run-the-trip-computation","__idx":16},"children":["How to run the trip computation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API EV Smart Routing is used to perform the trip computation."," ","The example trip is from Paris to Lyon. To make this trip computation with the API, some fields are required:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle"]},": this field can be set with the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle key id"]}," retrieved above in this tutorial in the chapter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["How to get the vehicle key"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startLon"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startLat"]},": these fields can be set with GPS-like coordinates. If you have a postal address, see the chapter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["How to convert a postal address to coordinates"]}," available above in this tutorial."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stopLon"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stopLat"]},": these fields can be set with GPS-like coordinates. If you have a postal address, see the chapter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["How to convert a postal address to coordinates"]}," available above in this tutorial."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["temperature"]},": this field can be set with an outside temperature in degrees Celsius. If you don't have this value, you can set it to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now we have all required values to start the computation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nPOST ${HOST_URL}/bgis/service/evsmartrouting/1.0\n{\n  \"vehicle\": \"eb72114c-1f74-4854-b4ce-c2b3f06405d5\",\n  \"temperature\": 20,\n  \"startLon\": 2.3414,\n  \"startLat\": 48.85717,\n  \"stopLon\": 4.82965,\n  \"stopLat\": 45.75917\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📌 Some optional fields:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["geoserver"]},": allows you to define the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["geoserver"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["geoserver"]}," defines the server configuration to use for the calculation. For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["here"]}," is a configuration running with the HERE map data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["algo"]},": the algorithm used to perform the trip computation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csps"]},": the charging station providers to be used during the trip."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initBatLvl"]},": the initial battery level in percent. This value will be used from the start coordinate to the destination or to the first charge (if required)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minBatLvl"]},": the minimal battery level in percent. Defines the value below which the battery should be charged during the trip."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minArrivalBatLvl"]},": the minimal arrival battery level in percent. Defines the value below which the battery should be charged at arrival of trip."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extraPayload"]},": defines the payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cur"]},": the currency as a 3-digit ISO code."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["departureTime"]},": the departure time as EPOCH in milliseconds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stepPointPluggingTime"]},": the time to take the cable, plug and unplug the connector."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["epl"]},": if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]}," field is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the geometry of the route is returned as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JSON"]}," object composed by longitude and latitude fields. This is very verbose. To reduce this information, you can set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]}," field to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," and set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["epl"]}," field to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},". Then, the returned geometry will be a Google Encoded Polyline."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See more details in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"request\"}}\nPOST ${HOST_URL}/bgis/service/evsmartrouting/1.0\n{\n  \"geoserver\": \"here\",\n  \"algo\": \"v3\",\n  \"csps\": [\n    \"benomad\"\n  ],\n  \"vehicle\": \"eb72114c-1f74-4854-b4ce-c2b3f06405d5\",\n  \"initBatLvl\": 100,\n  \"minBatLvl\": 10,\n  \"minArrivalBatLvl\": 15,\n  \"temperature\": 20,\n  \"extraPayload\": 75,\n  \"startLon\": 2.3414,\n  \"startLat\": 48.85717,\n  \"stopLon\": 4.82965,\n  \"stopLat\": 45.75917,\n  \"pl\": false,\n  \"epl\": true,\n  \"cur\": \"EUR\",\n  \"departureTime\": 1675444140000,\n  \"stepPointPluggingTime\": 300\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\"bemap\":{\"language\":\"json\"}}\n{\n  \"logTag\": \"c6766967-2360-4074-9633-6b82d6f06b9c\",\n  \"journey\": {\n    \"distance\": 467750,\n    \"duration\": 18155,\n    \"batteryLevel\": 15,\n    \"consumed\": 104.48,\n    \"chargingTime\": 1661,\n    \"departureTime\": 1675444140000,\n    \"arrivalTime\": 1675463956000,\n    \"vehicle\": \"e-tron 50 Quattro\",\n    \"savedCo2Emissions\": 0\n  },\n  \"inputInfo\": {\n    \"start\": {\n      \"address\": \"Pont Neuf, 75001 Paris, France\",\n      \"lon\": 2.3413990156969615,\n      \"lat\": 48.85717\n    },\n    \"stop\": {\n      \"address\": \"Place Antonin Gourju, 69002 Lyon, France\",\n      \"lon\": 4.8296482489665165,\n      \"lat\": 45.75917\n    }\n  },\n  \"boundingBox\": {\n    \"minLon\": 2.3059,\n    \"minLat\": 45.75149,\n    \"maxLon\": 4.91991,\n    \"maxLat\": 48.85848\n  },\n  \"route\": {\n    \"stepPoints\": [\n      {\n        \"id\": \"43032\",\n        \"brand\": \"IONITY\",\n        \"nameOfPool\": \"IONITY Aire de la Réserve\",\n        \"accessibility\": \"NA\",\n        \"availabilityStatus\": \"IN_SERVICE\",\n        \"longitude\": 3.197267,\n        \"latitude\": 47.974493,\n        \"distance\": 131170,\n        \"duration\": 5490,\n        \"arrivalTime\": 1675453230000,\n        \"departureTime\": 1675453882000,\n        \"consumed\": 29.243336564137937,\n        \"arrivalBatteryLevel\": 58.812202022340934,\n        \"departureBatteryLevel\": 69.98247794117722,\n        \"chargingPower\": {\n          \"currentType\": \"DC\",\n          \"power\": 120,\n          \"cnnTypeId\": 38\n        },\n        \"chargingTime\": 352,\n        \"countryCode\": \"FRA\",\n        \"country\": \"Frankreich\",\n        \"postalCode\": \"89116\",\n        \"city\": \"Précy-sur-Vrin\",\n        \"street\": \"A6\",\n        \"open24x7\": false,\n        \"comment\": \"Recharge jusqu'à 350KW - CCS\",\n        \"chargingStations\": [\n          {\n            \"id\": \"43032-Station1\",\n            \"availabilityStatus\": \"IN_SERVICE\",\n            \"bookable\": false,\n            \"chargingPoints\": [\n              {\n                \"id\": \"1\",\n                \"availabilityStatus\": \"IN_SERVICE\",\n                \"type\": 38,\n                \"connectorTypes\": [\n                  {\n                    \"id\": 38,\n                    \"key\": \"TYPE_2-CABLE_COMBO_CCS\",\n                    \"deprecated\": false,\n                    \"name\": \"Type 2 Combo\",\n                    \"norm\": \"Combo Type 2 based, DC\",\n                    \"maxPower\": 350,\n                    \"acSingle\": false,\n                    \"acThree\": false,\n                    \"dc\": true,\n                    \"cable\": true\n                  }\n                ],\n                \"currentType\": \"DC\",\n                \"power\": 350\n              }\n            ]\n          }\n        ],\n        \"theoreticalOptimalSpeed\": 0\n      },\n      {\n        \"id\": \"66352\",\n        \"brand\": \"Electra\",\n        \"nameOfPool\": \"greet hotel\",\n        \"accessibility\": \"NA\",\n        \"availabilityStatus\": \"IN_SERVICE\",\n        \"longitude\": 4.851663,\n        \"latitude\": 47.009289,\n        \"distance\": 184784,\n        \"duration\": 6279,\n        \"arrivalTime\": 1675460161000,\n        \"departureTime\": 1675461770000,\n        \"consumed\": 42.587559338235835,\n        \"arrivalBatteryLevel\": 9.99999999999998,\n        \"departureBatteryLevel\": 60.98900904734302,\n        \"chargingPower\": {\n          \"currentType\": \"DC\",\n          \"power\": 120,\n          \"cnnTypeId\": 38\n        },\n        \"chargingTime\": 1309,\n        \"country\": \"Frankreich\",\n        \"postalCode\": \"21200\",\n        \"city\": \"Beaune\",\n        \"street\": \"Route de Verdun 58\",\n        \"chargingStations\": [\n          {\n            \"id\": \"66352-Station1\",\n            \"availabilityStatus\": \"IN_SERVICE\",\n            \"bookable\": false,\n            \"chargingPoints\": [\n              {\n                \"id\": \"1\",\n                \"availabilityStatus\": \"IN_SERVICE\",\n                \"type\": 38,\n                \"connectorTypes\": [\n                  {\n                    \"id\": 38,\n                    \"key\": \"TYPE_2-CABLE_COMBO_CCS\",\n                    \"deprecated\": false,\n                    \"name\": \"Type 2 Combo\",\n                    \"norm\": \"Combo Type 2 based, DC\",\n                    \"maxPower\": 350,\n                    \"acSingle\": false,\n                    \"acThree\": false,\n                    \"dc\": true,\n                    \"cable\": true\n                  }\n                ],\n                \"currentType\": \"DC\",\n                \"power\": 300\n              }\n            ]\n          }\n        ],\n        \"theoreticalOptimalSpeed\": 0\n      }\n    ],\n    \"encodedPolyline\": \"ileiHwhhMGEg@a@YUu@g@_BmET...\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See more details in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-use-the-results","__idx":17},"children":["✅ Use the results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JSON"]}," object with two main fields: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey"]}," contains the summary information of the trip. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]}," lists the charge steps in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stepPoints"]}," field and contains the route geometry in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["encodedPolyline"]}," field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey"]}," object can be used to display the summary of trip in your application: the distance (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["distance"]},"), duration (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration"]},"), time spent in charge (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargingTime"]},"), arrival date and time (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrivalTime"]},") and consumption (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consumed"]},"). See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting#ev_smart_routing"},"children":["API reference"]}," for more details about these fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The trip geometry can be used to display the trip on a map in your application. Two fields are available for the geometry. One is the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["polyline"]},", which contains an array of coordinate objects with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lon"]}," (longitude) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lat"]}," (latitude) fields. The second is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["encodedPolyline"]},", which represents the geometry as a Google Encoded Polyline."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use the interactive example."]}]},"headings":[{"value":"⚡ Tutorial for the first trip in electrical vehicle","id":"-tutorial-for-the-first-trip-in-electrical-vehicle","depth":1},{"value":"🧭 Tutorial Structure","id":"-tutorial-structure","depth":2},{"value":"1. 🔑 How to Get the Vehicle Key","id":"1--how-to-get-the-vehicle-key","depth":2},{"value":"🏭 Get the Brand","id":"-get-the-brand","depth":3},{"value":"🔧 Request","id":"-request","depth":4},{"value":"🚙 Select the Vehicle (Get Vehicle Key ID)","id":"-select-the-vehicle-get-vehicle-key-id","depth":3},{"value":"🚘 Select the vehicle from a drop-down list (optional)","id":"-select-the-vehicle-from-a-drop-down-list-optional","depth":4},{"value":"🧩 1. Get vehicle names for a brand","id":"-1-get-vehicle-names-for-a-brand","depth":4},{"value":"🔋 2. Get the available battery names for the vehicle name.","id":"-2-get-the-available-battery-names-for-the-vehicle-name","depth":4},{"value":"⚡ 3. Get available chargers for the vehicle name and battery name.","id":"-3-get-available-chargers-for-the-vehicle-name-and-battery-name","depth":4},{"value":"🆔 4. Get the vehicle key id .","id":"-4-get-the-vehicle-key-id-","depth":4},{"value":"🔎 Find vehicle","id":"-find-vehicle","depth":2},{"value":"📚 Get All Vehicles for a Brand","id":"-get-all-vehicles-for-a-brand","depth":4},{"value":"📍 How to convert a postal address to coordinates","id":"-how-to-convert-a-postal-address-to-coordinates","depth":2},{"value":"Get the coordinate via the Geocoding API","id":"get-the-coordinate-via-the-geocoding-api","depth":3},{"value":"✨ Get the coordinate via Auto-complete API","id":"-get-the-coordinate-via-auto-complete-api","depth":3},{"value":"How to run the trip computation","id":"how-to-run-the-trip-computation","depth":2},{"value":"✅ Use the results","id":"-use-the-results","depth":3}],"frontmatter":{"seo":{"title":"⚡ Tutorial for the first trip in electrical vehicle"}},"lastModified":"2025-09-25T07:10:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/1evsmartrouting_first_request","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}