Aggiungere locali secondari all'indirizzo: esempi (solo Stati Uniti)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce segnali di risposta che giustificano un comportamento di aggiunta di un sottolocale da parte del sistema. Questi indicatori sono disponibili solo per gli indirizzi statunitensi.
Per il contesto, consulta Flussi di lavoro di esempio in
Crea la logica di convalida.
Esempio comune: aggiunta di locali secondari
Questo scenario illustra un indirizzo in cui il sistema potrebbe chiedere a un cliente di aggiungere un numero di unità all'indirizzo.
Indirizzo inserito
Regione
1450 Brickell Avenue, Miami, FL 33131-4065
US
Verdetto per un indirizzo a cui manca un'unità secondaria
Esempio di caso limite: aggiunta di locali secondari
Il seguente esempio riguarda una situazione in cui verdict indica
problemi di qualità dell'indirizzo che richiedono ulteriori indagini. Questi esempi illustrano anche come la logica può passare dal verdetto ai componenti dell'indirizzo per ottenere un quadro più completo al fine di migliorare la logica del sistema.
Componenti secondari mancanti e componenti dedotti e sostituiti
Questo esempio illustra l'inserimento di un indirizzo statunitense con una località mancante e un
codice postale errato.
Indirizzo inserito
Regione
1450 Brickell Avenue, FL 33132-4065
US
Verdetto per un componente secondario mancante e componenti dedotti e sostituiti
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-31 UTC."],[],[],null,["This document describes a number of real-world scenarios where the\nAddress Validation API provides response signals that warrant an *add subpremises*\nbehavior from your system. These signals are only available for US addresses.\nSee [Example workflows](/maps/documentation/address-validation/build-validation-logic#example-workflows) in\n**Build your validation logic** for context.\n| **Note:** The examples here are illustrative, but don't cover all scenarios.\n\nCommon example: add subpremises\n\nThis scenario illustrates an address in which your system might prompt a\ncustomer to add a unit number to the address.\n\n| Address entered | Region |\n|--------------------------------------------|--------|\n| 1450 Brickell Avenue, Miami, FL 33131-4065 | US |\n\nVerdict for an address missing a subpremises\n\nThe example below highlights the important signal. \n\n {\n \"inputGranularity\": \"PREMISE\",\n \"validationGranularity\": \"PREMISE\",\n \"geocodeGranularity\": \"PREMISE\",\n \"possibleNextAction\": \"CONFIRM_ADD_SUBPREMISES\"\n }\n\n| **Action:** For this address, you might prompt your user to add a unit number.\n\nEdge case example: add subpremises\n\nThe following example covers a situation in which the `verdict` indicates\naddress quality issues that warrant further investigation. This examples also\nillustrates how your logic can travel from the verdict to the address components\nto obtain a more complete picture in order to enhance your system logic.\n\nMissing subpremises and inferred and replaced components\n\nThis example illustrates entry of a US address with a missing locality and an\nincorrect postal code.\n\n| Address entered | Region |\n|-------------------------------------|--------|\n| 1450 Brickell Avenue, FL 33132-4065 | US |\n\nVerdict for a missing subpremises and inferred and replaced components \n\n {\n \"inputGranularity\": \"PREMISE\",\n \"validationGranularity\": \"PREMISE\",\n \"geocodeGranularity\": \"PREMISE\",\n \"hasInferredComponents\": true,\n \"hasReplacedComponents\": true,\n \"possibleNextAction\": \"CONFIRM_ADD_SUBPREMISES\"\n }\n\nFurther investigation of the address components reveals that the locality has\nbeen inferred, and the postal code has been replaced. \n\n {\n \"componentName\": {\n \"text\": \"33131\",\n }\n \"componentType\": \"postal_code\",\n \"confirmationLevel\": \"CONFIRMED\",\n \"replaced\": true\n },\n {\n \"componentName\": {\n \"text\": \"Miami\",\n \"languageCode\": \"en\"\n }\n \"componentType\": \"locality\",\n \"confirmationLevel\": \"CONFIRMED\",\n \"inferred\": true\n }\n\n| **Action:** For this address, you might prompt your user to add a unit number, or prompt them to review the entire address."]]