Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Avrupa Ekonomik Alanı (AEA) geliştiricileri
Yerelleştirilmiş yanıt değerleri, döndürülen parametre değerleri için yerelleştirilmiş metin sağlayan ek bir yanıt alanıdır. Seyahat süresi, mesafe ve birim sistemi (metrik veya İngiliz ölçü sistemi) için yerelleştirilmiş metin sağlanır. Alan maskesi kullanarak yerelleştirilmiş değerler isteyebilir, dili ve birim sistemini belirtebilir veya API tarafından çıkarılan değerleri kullanabilirsiniz. Ayrıntılar için LocalizedValues başlıklı makaleyi inceleyin.
Örneğin, Almanca (de) için bir dil kodu ve İngiliz birimleri belirtirseniz distanceMeters için 49889,7 değeri elde edersiniz. Ancak bu mesafe ölçümünü Almanca ve İngiliz birimleriyle sağlayan yerelleştirilmiş metin de elde edersiniz. Örneğin, "31 Meile".
Yerelleştirilmiş değerler için göreceğiniz örneği aşağıda bulabilirsiniz:
Dili veya birim sistemini belirtmezseniz API, dili ve birimleri aşağıdaki şekilde çıkarır:
ComputeRoutes yöntemi, konum ve mesafe birimlerini başlangıç yol noktasından çıkarır. Bu nedenle, ABD'deki bir yönlendirme isteği için API, en-US dili ve IMPERIAL birimleri çıkarır.
ComputeRouteMatrix yöntemi varsayılan olarak "en-US" dilini ve METRİK birimleri kullanır.
Yerelleştirilmiş değerler istemek için
Yanıtı yerelleştirilmiş değerlerle birlikte göndermek için aşağıdakileri yapmanız gerekir:
Alan maskenizde yerelleştirilmiş değerler isteyin. Örneğin:
REST
-H X-Goog-FieldMask: routes.localizedValues
RPC
const(fieldMask="routes.localizedValues")
Yerelleştirilmiş değerlerin belirli bir dilde veya birim sisteminde olmasını istiyorsanız:
dil kodunu ve birim sistemini belirtin:
[null,null,["Son güncelleme tarihi: 2025-07-22 UTC."],[[["\u003cp\u003eLocalized response values provide localized text for trip distance, duration, and unit system in Routes Preferred.\u003c/p\u003e\n"],["\u003cp\u003eYou can request localized values using a field mask and specify language and unit system or utilize the API's inferred values.\u003c/p\u003e\n"],["\u003cp\u003eIf unspecified, the API infers language and units based on the origin waypoint for \u003ccode\u003eComputeRoutes\u003c/code\u003e or defaults to 'en-US' and METRIC for \u003ccode\u003eComputeRouteMatrix\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo receive localized values, include \u003ccode\u003eroutes.localized_values\u003c/code\u003e in your field mask and optionally specify \u003ccode\u003elanguageCode\u003c/code\u003e and \u003ccode\u003eunits\u003c/code\u003e in your request.\u003c/p\u003e\n"]]],["Localized response values provide translated text for trip distance, duration, and unit system. To request them, include `routes.localized_values` in your field mask. You can specify the desired language and unit system (metric or imperial) via `languageCode` and `units`. If unspecified, the API infers them from the origin waypoint (ComputeRoutes) or defaults to 'en-US' and METRIC (ComputeRouteMatrix). The response includes localized text for distance, `duration`(with traffic model) and `staticDuration`(without traffic model).\n"],null,["# Request localized values\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n\u003cbr /\u003e\n\nLocalized response values are an additional response field that provides\nlocalized text for returned parameter values. Localized text is provided for\ntrip duration, distance, and unit system (metric or imperial). You request\nlocalized values using a field mask, and can either specify the language and\nunit system or use the values inferred by the API. For details, see\n[LocalizedValues](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#routelegsteplocalizedvalues).\n\nFor example, if you specify a language code for German (de) and imperial\nunits, you get a value for `distanceMeters` of 49889.7,\nbut also localized text providing that distance measurement in German and\nimperial units, so \"31 Meile.\"\n\nHere is an example of what you would see for localized values: \n\n```restructuredtext\n{ \"localized_values\":\n {\n \"distance\": { \"text\": \"31,0 Meile/n\" },\n \"duration\": { \"text\": 38 Minuten}.\n \"static_duration\": { \"text\": 36 Minuten}.\n }\n}\n```\n| Note: You get two values for the expected duration: `duration` uses the traffic model you specify, and `static_duration` does not take traffic into account. So, if your requested traffic model is `TRAFFIC_UNAWARE` these times are identical.\n\nIf you don't specify the language or unit system, the API infers the language\nand units as follows:\n\n- The `ComputeRoutes` method infers the location and distance units from the origin waypoint. So for a routing request in the US, the API infers `en-US` language and `IMPERIAL` units.\n- The `ComputeRouteMatrix` method defaults to 'en-US' language and METRIC units.\n\nTo request localized values\n---------------------------\n\nTo include localized values in the response, you need to do the following:\n\n1. Request localized values in your field mask. For example:\n\n **REST** \n\n ```restructuredtext\n -H X-Goog-FieldMask: routes.localizedValues\n ```\n\n **RPC** \n\n ```gdscript\n const (fieldMask = \"routes.localizedValues\")\n ```\n2. If you want the localized values in a specific language or unit system,\n specify the language code and unit system:\n\n ```console\n \"languageCode\": \"language_code\",\n \"units\": \"METRIC | IMPERIAL\",\n ```\n\n For example, this code snippet specifies the language as German (de), and\n METRIC units: \n\n ```console\n \"languageCode\": \"de\",\n \"units\": \"METRIC\",\n ```\n\n For more information, see\n [Language Support](/maps/faq#languagesupport).\n\nExample request\n---------------\n\n```curl\ncurl -X POST -d '{\n \"origin\": { \"location\": {\n \"latLng\": { \"latitude\": 37.7873146, \"longitude\": -122.4159327 } }\n },\n \"destination\": { \"location\": {\n \"latLng\": { \"latitude\": 37.7621008, \"longitude\": -122.4382503 } }\n },\n \"travelMode\": \"DRIVE\",\n \"computeAlternativeRoutes\": true,\n \"languageCode\": \"de\",\n \"units\": \"METRIC\"\n}' \\\n-H 'Content-Type: application/json' \\\n-H 'X-Goog-Api-Key: YOUR_API_KEY' \\\n-H 'X-Goog-FieldMask: routes.localizedValues' \\\n'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\nExample response\n----------------\n\nThe response returns localized values for the `distance`, `duration`, and\n`staticDuration` fields: \n\n```json\n{\n \"localizedValues\": {\n \"distance\": {\n \"text\": \"15,5 km\"\n },\n \"duration\": {\n \"text\": \"16 Minuten\"\n },\n \"staticDuration\": {\n \"text\": \"16 Minuten\"\n }\n }\n}\n```"]]
